FVSCHEDULE Function in ONLYOFFICE Spreadsheet Editor: Syntax, Examples and Troubleshooting
Find the future value of one initial investment when each period can have a different rate.
Verification status: See the evidence and test scope described in this guide. How formula examples are checked
Quick answer: Find the future value of one initial investment when each period can have a different rate. The exact English function and argument order are documented by ONLYOFFICE (checked 2026-10-13). Numerical results below are computed independently, not observed in the editor.
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.
What the function calculates — and when to use it
Unlike FV, which models a fixed rate and can include regular payments, FVSCHEDULE compounds one principal through a varying list of rates. Each schedule element is a per-period decimal (5% means 0.05). The official page explicitly says that empty schedule cells are treated as rate zero; this is NOT the same as silently omitting those periods from a separately reported period count.
Exact ONLYOFFICE syntax and argument order
=FVSCHEDULE(principal, schedule)
| Position | Argument | Required status, type and meaning | When omitted |
|---|---|---|---|
| 1 | principal |
Required numeric amount invested initially; use the same currency unit throughout | none |
| 2 | schedule |
Required contiguous cell range or array containing the successive period rates | none |
All listed arguments are required; the official reference does not specify an omitted-argument default. Enter all parameters in the order shown. Do not type the argument placeholders literally.
Documented vendor-specific note: The official FVSCHEDULE notes permit numeric rates and empty schedule cells, interpreting the empty entries as zero. There is no vendor statement here establishing text coercion, date handling, or a specific error value for invalid entries.
Independent mathematical model: principal × (1 + r₁) × (1 + r₂) × … × (1 + rₙ), with a blank rate interpreted mathematically as 0. This is an explanatory calculation model and is not an assertion about native error handling.
Reproduce the baseline worksheet, step by step
- Start a blank workbook in ONLYOFFICE Spreadsheet Editor and select an empty sheet. Use English formula names for the displayed examples.
- Enter the following input cells exactly. Enter amounts and period counts as numbers; enter rate schedules as numeric percentages where specified.
- Enter the first formula in the worked-example table into a blank output cell, such as
H2, unless the setup names a particular output cell. Avoid overwriting the input ranges. - Press Enter. Increase displayed precision to at least six decimal places. Compare with the independently calculated expected result.
- For the remaining rows, place each formula in a fresh blank output cell (
H3,H4, and so on). Cells/ranges in the sample setup remain fixed unless an example explicitly uses different literal arguments.
| Cell/range | Type or leave | Meaning |
|---|---|---|
B2 |
2% |
first period growth |
B3 |
3% |
second period growth |
B4 |
4% |
third period growth |
B5 |
leave truly empty | documented zero rate |
B6 |
-1% |
fifth-period loss |
B8 |
1000 |
starting investment |
C2:C6 |
enter 5% in each of the five cells |
constant-rate comparison |
D2:D6 |
enter 0% in each of five cells |
zero-rate comparison |
E2:E6 |
10%, -10%, 10%, -10%, 10% top to bottom |
alternating market scenario |
Baseline interpretation: =FVSCHEDULE(B8,B2:B6) computes five successive changes: $1,000 × 1.02 × 1.03 × 1.04 × 1 × 0.99. B5 is deliberately blank to test the precise documented empty-cell rule.
Twelve copyable worked formulas and independently calculated answers
The expected result uses a decimal number with six digits after the decimal point (half-up rounding). Results are mathematical expectations from a 60-digit Decimal calculation checked with a separate floating-point implementation; no formula was executed inside ONLYOFFICE.
| # | Enter this exact formula | Expected numerical result | What this case demonstrates |
|---|---|---|---|
| 1 | =FVSCHEDULE(B8,B2:B6) |
1081.697760 |
five scheduled periods; one blank rate counts as zero |
| 2 | =FVSCHEDULE(B8,B2:B4) |
1092.624000 |
three changing positive rates |
| 3 | =FVSCHEDULE(2500,B2:B6) |
2704.244400 |
different starting capital, same scenario |
| 4 | =FVSCHEDULE(1000,C2:C6) |
1276.281563 |
five identical 5% growth periods |
| 5 | =FVSCHEDULE(1000,D2:D6) |
1000.000000 |
zero-rate schedule leaves capital unchanged |
| 6 | =FVSCHEDULE(1000,E2:E6) |
1078.110000 |
alternating gains and losses compound multiplicatively |
| 7 | =FVSCHEDULE(1000,B2:B3) |
1050.600000 |
two-step investment projection |
| 8 | =FVSCHEDULE(500,B2:B4) |
546.312000 |
principal scaling |
| 9 | =FVSCHEDULE(1000,B2:B5) |
1092.624000 |
blank fourth period: a zero change, not an omitted period |
| 10 | =FVSCHEDULE(1000,B6:B6) |
990.000000 |
single 1% loss |
| 11 | =FVSCHEDULE(1000,C2:C3) |
1102.500000 |
two equal compounding periods |
| 12 | =FVSCHEDULE(10000,E2:E6) |
10781.100000 |
larger investment with volatile rates |
Advanced applications, interpretation and checks
Build a variable-rate investment dashboard
Put period names in column A beside the rate cells in B2:B6. Keep the principal in B8; calculate future value in H2 with =FVSCHEDULE(B8,B2:B6). For a pessimistic/optimistic comparison, replace the schedule with alternative input columns while keeping the principal fixed. Record the assumption that each row represents exactly one period. Rates for calendar years and months must not be mixed without converting periods.
Compare two paths with the same average
5% then -5% does not cancel: 1.05 × 0.95 = 0.9975. The arithmetic mean is zero but the two-period compounded outcome is a loss of 0.25%. Use actual compound products, not average-rate multiplication. A negative rate -100% mathematically reduces the investment to zero; how the native program reports out-of-range inputs is untested.
Scale the investment without changing the rate path
For a common schedule, doubling principal doubles the final value. Verify this invariant by comparing =FVSCHEDULE(1000,B2:B6) to =FVSCHEDULE(2000,B2:B6); it is a useful audit of accidental absolute vs percentage entries.
Relate FVSCHEDULE to FV without conflating them
When every schedule entry is identical, the mathematical total is principal × (1+rate)^periods. The separate ONLYOFFICE FV reference describes a periodic-payment model and is not an alias for FVSCHEDULE. Do not add deposits to the rate schedule; they are separate cash flows.
Common errors, limits and troubleshooting
| Problem | Likely cause / investigation |
|---|---|
| Investment unexpectedly unchanged | Rate cells contain 0% or are empty; the vendor documents empty rates as zero. |
| Huge projection | Entered 5 rather than 5% or 0.05 for a 5% rate. |
| Wrong number of periods | Selected the wrong schedule range, or confused a blank zero-rate period with a missing year. |
| Result differs across workbooks | Mixed month/annual rates, text instead of numeric percentages, or regional settings. |
| Native error or inconsistent text result | Check the rate cells and exact build; the official entry does not specify coercion or the error code. Do not infer from other spreadsheets. |
Additional validation and edge-case checklist
- Check that
B5is genuinely empty, not a formula returning""(this distinction has not been natively checked). - Test that
=FVSCHEDULE(1000,D2:D6)preserves 1000 with a five-zero schedule. - Replace one rate with a strongly negative value only in a disposable workbook; do not assign a guessed native error.
Error handling: The vendor reference does not list every invalid-input result. Diagnose an actual error using the entered values and installed build rather than importing an error rule from another spreadsheet.
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
- ONLYOFFICE FVSCHEDULE function reference: purpose, syntax and argument meanings.
- Spreadsheet Editor formula entry: function catalog and English entry syntax.
- Docs release history and Desktop Editors release history: separate product timelines.