DATEDIF Function in Google Sheets: Syntax, Examples & Compatibility
Learn how to measure completed years or days between two dates without counting partial anniversaries as full years in Google Sheets. Includes syntax, two verified-by-reasoning results, troubleshooting and portability notes.
Verification status: Official documentation referenced; example outcomes independently reasoned or arithmetically checked where stated. Not executed in Google Sheets. How formula examples are checked
Quick answer: measure completed years or days between two dates without counting partial anniversaries as full years in Google Sheets. The reproducible examples below use explicit values so the formula’s meaning is testable without a large workbook.
Evidence: The function name and syntax are documented in the linked vendor function reference. Expected outputs were independently reasoned or checked outside the application. These are not native Google Sheets test results. A guide being published here does not certify every software release or file-import scenario.
Syntax and arguments
=DATEDIF(start_date, end_date, unit)
unit is a quoted code such as "Y" for complete years or "D" for elapsed days. The start date should not be later than the end date.
Best use case: Measure completed years or days between two dates without counting partial anniversaries as full years.
Set up the example sheet
For a service-anniversary tracker, keep the dates fixed with DATE for verification. This avoids a year calculation changing as TODAY advances.
Enter the formula in an unused cell. For a formula returning several values, leave an unobstructed area where those values can expand. These formulas use comma argument separators in a typical English-language locale; commas or semicolons inside quoted text are data, not argument separators. Adapt the separator if your regional settings require it.
Worked example 1: DATEDIF with known input
=DATEDIF(DATE(2020,1,1),DATE(2025,1,1),"Y")
Expected output: 5.
Five complete anniversaries occurred between 1 January 2020 and 1 January 2025.
Worked example 2: a second DATEDIF case
=DATEDIF(DATE(2025,1,10),DATE(2025,2,9),"D")
Expected output: 30.
Subtracting the two date serials yields 30 elapsed days.
Compare both results before replacing literal values or short sample ranges with your own workbook data. For a spilling formula, compare every output cell, not only the top-left result.
Practical advice and troubleshooting
When this formula helps: Use DATEDIF only for the unit you intend: the "M" and "Y" units count complete months and years, unlike a fraction-of-year formula.
Important edge case: Microsoft flags limitations in the "MD" argument. Avoid it for audit-critical age or tenure calculations without a verified alternative.
If the result differs, first verify the text-versus-number types of the input cells, the argument separators for your locale, and the range size. For dynamic arrays, inspect occupied cells in the output area. An error that looks like a missing function may reflect a software version rather than incorrect data.
Compatibility and version considerations
Google documents DATEDIF directly; Excel retains it for compatibility and its Microsoft documentation warns about some results.
Check your installed release for availability and dynamic-array support.
Function availability and parameter behavior must be judged for the specific application and release; a function documented in one spreadsheet does not automatically work in another.
Related guides and official documentation
-
Google Sheets documentation for DATEDIF — function syntax and current vendor information.
Editorial verification: Vendor catalogue referenced as of 2026-10-12. The two example outputs are independently reasoned; no native application run, screenshot, or version-specific output is claimed. Review the editorial testing standards if you require stronger proof before importing a workbook.