Contact

PV Function in ONLYOFFICE Spreadsheet Editor: Syntax, Examples and Troubleshooting

Financial Intermediate ONLYOFFICE Spreadsheet Editor

Value a fixed future payment stream or future lump sum at a given periodic discount rate.

Verification status: See the evidence and test scope described in this guide. How formula examples are checked

Discount recurring cash flows and an optional terminal value back to today. The official ONLYOFFICE PV function reference confirms the English formula name, argument order and documented meanings. The examples are independently calculated mathematical expectations, not results observed in an installed ONLYOFFICE application.

Availability and version history

  • Introduced: The original introduction version and date are not established by the official sources checked.
  • Availability: Documented in the current ONLYOFFICE Spreadsheet Editor help; no final working-version endpoint is established.
  • Scope: Docs and Desktop Editors release separately. This unversioned help does not establish availability in every older build, mobile client or deployment.
  • Checked: October 14, 2026, against the official function reference. Documentation check; not a new native test.

Exact documented syntax and argument order

=PV(rate, nper, pmt, [fv], [type])
Position Argument Required status, data type and interpretation Omitted default
1 rate Required numeric discount rate per payment period —
2 nper Required number of payment periods —
3 pmt Required signed regular payment, e.g. −200 for outflows made by a borrower —
4 fv Optional signed future terminal cash flow 0
5 type Optional timing: 0 end of period, 1 beginning 0

Defaults: fv=0; type=0 (end of period). Square brackets mark optional inputs; do not type them. The help page does not explicitly enumerate every invalid-input behaviour or native error code.

Rates and signed cash flows: The vendor specifically advises keeping the units of rate and nper consistent and recording money paid out with negative cash-flow signs, money received with positive signs. 6%/12 is a per-month rate for a nominal 6% annual rate with monthly periods; it is not a promise that a lender’s actual interest schedule follows this convention.

Reproduce the worksheet from a blank workbook

  1. Open a new blank spreadsheet in ONLYOFFICE Spreadsheet Editor. Select the English formula language, or adapt the formula names/separators to the actual configured locale. Choose a blank sheet.
  2. Enter these literal inputs in the stated cells in column B. For entries beginning with =, enter the formula. For negative payments, include the minus sign.
  3. Put each worked formula below in a fresh cell such as D2, D3, …; do not overwrite the baseline B-column inputs. Increase displayed decimal places for precision comparisons.
  4. Press Enter after each formula or use Formula → Function (the official function-insertion guide describes the Insert Function dialog and Shift+F3). Compare with expected outputs, recording the exact Desktop or Docs/web build and locale when native testing becomes available.
Cell Enter exactly Purpose
B2 =6%/12 Periodic discount rate = 0.005
B3 60 Number of monthly payments
B4 -200 A $200 monthly cash outflow
B5 0 No separate future balance
B6 0 Payments made at period end

Example scope: Only the formula labeled as using B-cells depends on the preceding baseline. The other examples use explicit literal values and may be entered in any otherwise blank output cell. Formula examples use the vendor’s English, comma-separated syntax; other locale settings may require adaptation, which was not natively tested.

Complete worked formulas and expected outputs

Independent expected results (rounded to six decimal places (half-up)) are provided for every row. These are not screenshots, measured native ONLYOFFICE outputs, or claims of product compatibility in historical builds.

# Formula to type (copy with leading =) Independently calculated expected value What the example demonstrates
1 =PV(B2,B3,B4) 10345.112150 present value of five years of $200 monthly outflows
2 =PV(B2,B3,B4,B5,B6) 10345.112150 explicit default terminal value and end timing
3 =PV(0,12,-100) 1200.000000 interest-free 12-payment annuity
4 =PV(6%/12,60,-200,0,1) 10396.837711 payments at the beginning of each month
5 =PV(4%/12,60,-200) 10859.813780 lower APR raises discounted present value
6 =PV(8%/12,60,-200) 9863.686667 higher APR lowers discounted present value
7 =PV(6%/12,60,0,-10000) 7413.721962 value of a one-time future $10,000 outflow
8 =PV(6%/12,60,-200,-3000) 12569.228739 payment stream with an extra terminal cash outflow
9 =PV(5%,10,-1200) 9266.081915 ten annual $1,200 outflows discounted at 5%
10 =PV(0,12,100) -1200.000000 positive future receipts mean an offsetting negative PV
11 =PV(6%/12,12,-200) 2323.786413 shorter 12-month annuity
12 =PV(6%/12,120,-200) 18014.690665 longer 120-month annuity

Result interpretation: The answer is a signed monetary amount in the same unit as the payment and balance inputs. Its sign follows the cash-flow viewpoint, not a percentage format.

Advanced workflows, mathematical checks and real use cases

Loan affordability versus annuity value

=PV(6%/12,60,-200) estimates how much can be received today against 60 monthly payments of $200 under a constant 6% nominal annual discount rate. That is the mathematical amount financed; it excludes lender fees, tax treatments and credit decisions. Use =PMT(6%/12,60,PV(6%/12,60,-200)) to return the negative monthly payment as an independent algebraic cross-check (subject to display rounding).

One-time future amount and viewpoint

=PV(6%/12,60,0,-10000) uses a future outflow of 10,000 and returns the positive offsetting amount today, expected 7413.721962. From a saver’s viewpoint, a future receipt is positive: =PV(6%/12,60,0,10000) then returns −7413.721962, the initial investment outflow. Either convention can express the same discounted magnitude, but the labels and signs must be consistent.

At zero interest, the mathematical model reduces to a simple sum: =PV(0,12,-100) has expected value 1200. A zero-rate example is a limiting cash-flow model, not evidence of every invalid-input response.

Timing sensitivity

For the same 60 payments, type=1 places them one period earlier. Their mathematical present value is larger than end-of-period payments. It is not a different interest rate.

Financial identity for audit

For nonzero periodic r, put A=((1+r)^n−1)/r. Expected PV=−[fv+pmt·A·(1+r·type)]/(1+r)^n; at zero rate PV=−(fv+n·pmt). Check sign conventions before applying the expression to debt or investment decisions.

Troubleshooting, input constraints and limitations

Symptom or question Explanation or action Evidence boundary
Unexpected minus sign A positive stream of payments is incoming cash, yielding a negative present value as the offsetting cash flow. Financial-model guidance; native coercion/error display untested.
Loan eligibility mismatch PV discounts the specified payments; it does not include lender qualification, fees or variable interest. Financial-model guidance; native coercion/error display untested.
Unit inconsistency Keep rate per payment period and nper as the total number of those same periods. Financial-model guidance; native coercion/error display untested.
Comparison to simple multiplication A positive discount rate makes a distant payment stream worth less today than its undiscounted sum. Financial-model guidance; native coercion/error display untested.
Formula name unrecognized Verify the formula language in File → Advanced Settings, search the Function dialog, and record the exact app version and locale. Current English catalogue supports the name; older editions and localized names were not verified.
Unexpected numerical precision Show more decimal places and compare unrounded outputs against independently computed cash-flow equations. Do not round intermediate values for reconciliation. Mathematical precision expectation only; numeric-engine rounding not natively verified.
Spreadsheet shows an error Check types, supported timing values, formula separators, and period ranges; record actual build, inputs and exact error text before diagnosing. Official function page does not establish every error code, so none is invented.

Limits of the model: Annuity present values require a constant rate, constant payment and consistent cash-flow perspective; published examples are mathematical expectations. The official source is about a calculation function rather than product-specific financial advice. Changing interest rates, fees, taxes, extra or skipped payments, compounding conventions, day-count conventions, and transaction timing may produce different real-world results.

FV advances signed payments to a future date. PMT finds the constant payment that corresponds to a known PV; NPV handles discrete cash-flow arrays. See the vendor’s references rather than assuming identical behaviour in other spreadsheet products:

  • FV — official ONLYOFFICE financial-function reference.
  • PMT — official ONLYOFFICE financial-function reference.
  • NPER — official ONLYOFFICE financial-function reference.
  • RATE — official ONLYOFFICE financial-function reference.
  • NPV — official ONLYOFFICE financial-function reference.

Also consult the ONLYOFFICE Function catalogue and formula-entry instructions and Spreadsheet Editor advanced settings.

Locale and workbook compatibility

The examples use English function names, decimal points and comma argument separators, matching the function-entry guide. Adapt notation to the installed formula-language and region settings. When moving a workbook between products, recalculate the small sample in the destination version before trusting the full model. Display precision is separate from the stored value; retain unrounded intermediate values when reconciling totals.

Official references