Contact

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

Financial Intermediate ONLYOFFICE Spreadsheet Editor

Forecast a balance after recurring deposits or payments at a fixed rate.

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

Future value of recurring periodic cash flows and an optional opening balance. The official ONLYOFFICE FV 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

=FV(rate, nper, pmt, [pv], [type])
Position Argument Required status, data type and interpretation Omitted default
1 rate Required numeric rate per payment period (for nominal annual 6% with monthly payments, 6%/12) —
2 nper Required number of payment periods —
3 pmt Required signed recurring payment; money deposited is an outflow (−150) —
4 pv Optional signed amount today, e.g. −2000 initial deposit 0
5 type Optional payment timing: 0 end of period, 1 beginning 0

Defaults: pv=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 interest rate, 0.005
B3 60 Number of monthly deposits
B4 -150 Deposit each month (cash outflow)
B5 0 Initial cash flow/present value
B6 0 End-of-period payments

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 =FV(B2,B3,B4) 10465.504576 baseline future savings from a recurring $150 contribution
2 =FV(B2,B3,B4,B5,B6) 10465.504576 explicitly supplied default opening balance and end timing
3 =FV(0,12,-100) 1200.000000 zero-rate deposits accumulate without growth
4 =FV(4%/12,60,-150) 9944.846727 lower nominal annual return scenario
5 =FV(8%/12,60,-150) 11021.528437 higher nominal annual return scenario
6 =FV(6%/12,60,-150,0,1) 10517.832099 contributions due at the beginning of the period
7 =FV(6%/12,60,-150,-2000,0) 13163.204882 initial $2,000 cash outflow augments savings
8 =FV(6%/12,60,0,-5000) 6744.250763 compound one-time $5,000 contribution
9 =FV(5%,10,-1200) 15093.471043 annual $1,200 deposits for ten years
10 =FV(6%/12,24,-200) 5086.391048 24 monthly deposits at nominal 6% APR
11 =FV(6%/12,60,150) -10465.504576 positive payments reverse cash-flow sign
12 =FV(0,12,0,-1200) 1200.000000 zero-rate, no payments: recover initial value

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

A monthly savings plan

The baseline uses a 6% nominal annual rate paid monthly (B2=6%/12), 60 deposits of 150 each (B3=60, B4=-150) and no opening deposit. Use =FV(B2,B3,B4) for the predicted accumulated amount. Because a negative deposit is an outflow to the saver, the estimated savings balance is positive. A zero-rate example reduces to the arithmetic sum of deposits.

Beginning versus end of period

=FV(6%/12,60,-150,0,1) models contributions at the start of each month. With type=1 each contribution accrues an extra month’s interest compared with type=0, assuming identical rates and payments. Do not add an extra deposit to compensate: the period timing is already encoded in the fifth argument.

Reconcile with present value

For the baseline with no initial deposit, the full cash-flow inverse is =PV(6%/12,60,-150,FV(6%/12,60,-150),0), with expected result 0 apart from numerical rounding. The negative deposits and positive terminal balance are the two sides of the same model; they are not double-counted. If you include an initial deposit of −2000 in FV, the corresponding full inverse should recover −2000.

To value only the future savings balance as a positive amount today, use =PV(6%/12,60,0,-FV(6%/12,60,-150)). Its expected magnitude is 7758.834113. This second expression excludes periodic payments and discounts the terminal amount alone; label which question the calculation answers.

Financial identity for audit

Let r=rate, n=nper, P=pmt, and V=pv, all signed. For r≠0, define A=((1+r)^n−1)/r. The expected ending value is −[V(1+r)^n+P·A·(1+r·type)]. When r=0, the limiting result is −(V+nP). These are independent cash-flow algebra, not evidence of ONLYOFFICE runtime precision.

Troubleshooting, input constraints and limitations

Symptom or question Explanation or action Evidence boundary
Negative FV Your payments or pv may be positive inflows rather than negative investment outflows; use a consistent viewpoint. Financial-model guidance; native coercion/error display untested.
Value grows too rapidly Check whether an annual rate was mistakenly used for monthly periods or a term in years was entered instead of payments. Financial-model guidance; native coercion/error display untested.
Small beginning/end difference For a low rate or few payments, the timing effect may legitimately be small; display more digits. Financial-model guidance; native coercion/error display untested.
Variable return plan FV assumes one fixed rate and constant payment; use a dated cash-flow model for changing returns. 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: The vendor specifies signed payments and matching periodic units. An estimate does not include taxes, investment fees, inflation or unpredictable returns. 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.

For a time-zero balance or annuity valuation use PV. PMT solves the regular payment rather than the balance. FVSCHEDULE deals with a schedule of rates, not necessarily repeated contributions. See the vendor’s references rather than assuming identical behaviour in other spreadsheet products:

  • PV — official ONLYOFFICE financial-function reference.
  • PMT — official ONLYOFFICE financial-function reference.
  • NPER — official ONLYOFFICE financial-function reference.
  • RATE — official ONLYOFFICE financial-function reference.
  • FVSCHEDULE — 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