DATE Function in ONLYOFFICE Spreadsheet Editor: Syntax, Examples and Date Checks
Build a calendar date from numeric year, month and day parts without parsing locale-ambiguous text.
Verification status: Official documentation referenced; example outcomes independently reasoned or arithmetically checked where stated. Not executed in ONLYOFFICE Spreadsheet Editor. How formula examples are checked
DATE function in ONLYOFFICE Spreadsheet Editor
Quick answer
Build a calendar date from numeric year, month and day parts without parsing locale-ambiguous text. In the English ONLYOFFICE DATE reference, the exact published signature is =DATE(year, month, day). All displayed outputs below are independently calculated expectations, not results observed in an installed ONLYOFFICE editor.
Purpose and correct mental model
DATE assembles date parts into a date value. It is useful when year, month and day arrive as separate numeric fields, for preparing date columns that can be sorted and used by other date functions, and for preventing regional date-string confusion. The official DATE help documents the order year, month, day and describes the default display as MM/dd/yyyy; you can choose another display format without changing the intended calendar date.
The vendor lists month as 1–12 and day as 1–31. A combination such as February 30 is not a valid Gregorian date; this guide does not promise the engine will normalize or reject it in any particular way. Use verified, valid input rows first, and test overflow or error behaviour natively if your application needs it.
Exact official syntax, argument order and defaults
=DATE(year, month, day)
| Argument | Required? | Definition and boundaries | Example |
|---|---|---|---|
year |
Required | Numeric four-digit year; official reference describes four digits. | 2024 |
month |
Required | Numeric month 1 through 12 in the published reference. | 2 |
day |
Required | Numeric day 1 through 31 in the published reference; the resulting calendar date must also exist for the examples here. | 29 |
The arguments above are required; the current official reference documents no optional parameters or default argument values for this function. In these formulas, parameter labels such as serial_number describe argument positions; you type a cell reference or numeric expression instead. English examples use commas. All values in the shared exercise are intended to represent unambiguous Gregorian calendar dates. DATE vendor reference.
Version, edition, regional and date-system notes
- ONLYOFFICE Docs / browser editor: vendor help confirms the documented function name and arguments, not reproducibility on every deployed server version. The Docs release history records version 9.4.0 (May 20, 2026), but does not establish that this function first appeared then.
- ONLYOFFICE Desktop Editors: desktop release history is separately maintained; Desktop 9.4.0 is dated May 19, 2026. Do not infer identical support, same error strings, or the introduction version from the shared product branding.
- Android, iOS and other integrations: this investigation does not establish native function support or evaluation parity for a specific app build. Open the function picker in the target editor and perform a local test.
- Formula language and locale: the Advanced Settings documentation describes separate Formula Language and Region controls, including date-display and separator settings. Formulas here use English names,
=and commas. If the installed interface expects localized names or a different list separator, adapt and independently validate entry; date cells should be formatted explicitly rather than assumed to display the same across regions. - 1900 vs. 1904 date system: the same Advanced Settings page documents an optional 1904 date system. It affects date serial calculations and imported workbooks. The tables below compare calendar dates, not hard-coded serial integers. Record the selected date system before comparing workbooks from another spreadsheet product.
Document checks: 2026-10-11 UTC. These are documentation findings, not test logs from a native ONLYOFFICE session.
Reproducible practice sheet (shared by all four date guides)
Create a clean spreadsheet. Type the headings Year, Month, Day, Constructed date, YEAR result, MONTH result, DAY result into A1:G1. Enter the following numbers in A2:C9 (without quotation marks); never paste ambiguous date strings such as 03/04/2026 as input data. Place =DATE(A2,B2,C2) in D2 and fill down to D9. Set D2:D9 to a date format in which the calendar year, month and day are unambiguous—for example yyyy-mm-dd when available. If you see a large integer instead, the date display format probably needs adjusting.
| Row | A — Year | B — Month | C — Day | Independently expected displayed calendar date in D | E — YEAR | F — MONTH | G — DAY |
|---|---|---|---|---|---|---|---|
| 2 | 2024 | 2 | 29 | 2024-02-29 | 2024 | 2 | 29 |
| 3 | 2025 | 1 | 1 | 2025-01-01 | 2025 | 1 | 1 |
| 4 | 2026 | 10 | 11 | 2026-10-11 | 2026 | 10 | 11 |
| 5 | 2000 | 12 | 31 | 2000-12-31 | 2000 | 12 | 31 |
| 6 | 2030 | 3 | 15 | 2030-03-15 | 2030 | 3 | 15 |
| 7 | 2020 | 6 | 1 | 2020-06-01 | 2020 | 6 | 1 |
| 8 | 2010 | 7 | 4 | 2010-07-04 | 2010 | 7 | 4 |
| 9 | 2026 | 12 | 31 | 2026-12-31 | 2026 | 12 | 31 |
For E2, enter =YEAR(D2); for F2, enter =MONTH(D2); for G2, enter =DAY(D2). Fill all three formulas down through row 9. The shared example-dates.csv in this batch contains the input numbers and independently expected values; the CSV is a test fixture, not an execution transcript. These expected outputs were checked using Python’s Gregorian datetime.date types, which do not simulate ONLYOFFICE’s formula engine or serial-date edge cases.
To reproduce the test without filling, enter each formula from the table below directly into its indicated output cell. Use the worksheet’s actual values, not screenshots or an imagined workbook.
Worked DATE examples
Set A2:C9 to the shared numeric components above. In each D-row, use the matching DATE(Arow,Brow,Crow) formula, then apply a date format such as yyyy-mm-dd. The expected values below are calendar dates, not the exact displayed serial numbers. The leap-year case deliberately uses February 29, 2024, which is a Gregorian leap day.
| Output cell | Enter this formula | Independently expected result | Reason |
|---|---|---|---|
| D2 | =DATE(A2,B2,C2) |
2024-02-29 | Leap-day test |
| D3 | =DATE(A3,B3,C3) |
2025-01-01 | Year boundary |
| D4 | =DATE(A4,B4,C4) |
2026-10-11 | Calendar component |
| D5 | =DATE(A5,B5,C5) |
2000-12-31 | Year boundary |
| D6 | =DATE(A6,B6,C6) |
2030-03-15 | Calendar component |
| D7 | =DATE(A7,B7,C7) |
2020-06-01 | Calendar component |
| D8 | =DATE(A8,B8,C8) |
2010-07-04 | Calendar component |
| D9 | =DATE(A9,B9,C9) |
2026-12-31 | Year boundary |
Advanced example 1: first day of the reporting month
With D4 = 2026-10-11, enter =DATE(YEAR(D4),MONTH(D4),1) in H4 and format as a date. Independently expected: 2026-10-01. This preserves the year and month while selecting a fixed day of 1; it avoids parsing a date string.
Advanced example 2: first day of the calendar quarter
Enter =DATE(YEAR(D4),3*INT((MONTH(D4)-1)/3)+1,1) in H5 and apply the same date format. Expected: 2026-10-01. October belongs to the fourth quarter, whose first month is October (10). The INT and MONTH steps were independently calculated; the combined formula has not been executed in ONLYOFFICE. Check this expression on the user’s actual locale, as separators may vary.
Advanced example 3: a fixed annual reporting boundary
Enter =DATE(YEAR(D4)+1,1,1) in H6: expected 2027-01-01. Use this when defining the start of the next calendar year. It does not by itself define fiscal calendars that begin in other months.
Practical data-quality example
Suppose import fields in A10:C10 contain 2024, 2, 29. =DATE(A10,B10,C10) is expected to represent 2024-02-29, a real leap date. Before importing high-stakes data, validate that values fall in documented argument ranges and the original date actually exists. If a source uses month-first or day-first text, do not guess from the text alone.
Function-specific pitfalls
- Display versus underlying value:
DATEis used in date formulas; format the result as a date before reading it. A cell showing a serial integer is not automatically an incorrect date result. - No missing-argument default is documented: all three parameters appear mandatory in the official signature; do not omit the day or month.
- Four-digit years: the reference explicitly describes a four-digit year. This guide deliberately avoids two-digit year interpretations and pre-1900 dates.
- Leap years: 2024-02-29 is a valid leap-day check; 2025-02-29 is invalid and intentionally excluded rather than making an unsupported error claim.
- DATE versus DATEVALUE: DATE uses numeric components; DATEVALUE parses date text and can depend on format and localization. These tasks are not interchangeable.
Troubleshooting and boundaries
- The date displays as an integer: ensure the output cell uses a date format. The date serial system is a separate setting from the on-screen formatting. Do not replace an integer with a text date and assume calculations will still work.
- A formula shows as text: enter it with a leading
=, avoid quoted formula strings, and confirm the cell is not forced to text formatting. Use the Insert Function picker to check the installed function name. - A copied formula gives unexpected values: compare each reference with the practice table; for example,
D4is the constructed 2026-10-11 date, whileA4is just the year 2026. A YEAR/MONTH/DAY function called on A4 would be interpreting a serial number, not reading the digits “2026” as a year. - Dates imported from another locale:
04/05/2026is ambiguous without regional context. PreferDATE(2026,5,4)or separately entered numeric parts for a reproducible check. - 1900/1904 mismatches: before trusting dates in a migrated Excel file, verify the workbook’s date-system settings. A function name matching in two apps does not prove equality of serial-number handling.
- Invalid or blank inputs: the short official help pages do not document a complete error-code and type-coercion matrix. Test blanks, negative serials, strings, the year-1900 boundary and localized dates in the target installation; do not claim a specific
#VALUE!/#NUM!result without observing it. - Unsupported edition or version: check the real product version, Formula Language, platform and installed function picker, then reduce the example to one literal
DATE(...)and one extraction. A web documentation page is not a compatibility matrix.
Deliberately unresolved edge cases: the consequences of a day beyond the number of days in a month, month 0 or 13, years before 1900, decimal arguments, and non-Gregorian display calendars are not guaranteed by the short ONLYOFFICE references. The worked examples stay within documented argument ranges and valid Gregorian dates. Do not promote Excel’s normalization behaviour to a verified ONLYOFFICE rule.
Compatibility: documented facts versus untested assumptions
Microsoft Excel documents corresponding DATE, YEAR, MONTH and DAY formulas, and Microsoft explains the use of sequential date serials. These are analogous English function names, not proof of matching outcomes for boundary dates, formula-language translations, cross-version imports, or 1900/1904 settings. Excel’s official date-function reference is a useful contrast; ONLYOFFICE Advanced Settings documents the date-system option inside this editor.
In particular, changing a date’s display format is not equivalent to changing the underlying date value. Do not use textual dates for cross-software validation. Export a small workbook and record the versions and chosen date systems in both products if interoperability is important. No comparative application execution was done during this research pass.
Related guides and checked external references
- YEAR — official ONLYOFFICE reference (checked 2026-10-11 UTC).
- MONTH — official ONLYOFFICE reference (checked 2026-10-11 UTC).
- DAY — official ONLYOFFICE reference (checked 2026-10-11 UTC).
- DATEVALUE — official ONLYOFFICE reference (checked 2026-10-11 UTC).
- INT — official ONLYOFFICE reference (checked 2026-10-11 UTC).
Official reference and verification
- ONLYOFFICE Spreadsheet Editor — function documentation
- ONLYOFFICE Insert Functions index
- Docs release history
- Desktop 9.4.0 is dated May 19, 2026
- Advanced Settings documentation
- DATEVALUE
- YEAR — official ONLYOFFICE reference
Verification status: Official documentation checked; example outcomes were independently reasoned or arithmetically checked where applicable. Not executed in ONLYOFFICE Spreadsheet Editor.
- No genuine ONLYOFFICE Spreadsheet Editor screenshots are included; this guide does not use mock application images.