DATEDIF

calculates difference between two dates · from excel · excel: not yet compared · sheets: not yet compared

signature

DATEDIF(start_date, end_date, unit)

returns: number

argumentrequired
start_date required
end_date required
unit required

examples

formula and result, taken from the engine's own test suite — every result below is asserted in CI, not written by hand.

fx =DATEDIF(DATE(2020,1,1), DATE(2026,7,27), "Y") 6

errors

error values observed from the engine — each with a call that produces it.

errorproduced by
#VALUE! =DATEDIF(DATE(2026,1,15), DATE(2026,1,15), 2)

related

  • DATE creates date from year, month, day
  • DATEVALUE converts date text to serial number
  • DAY returns day of month from date
  • DAYS returns number of days between two dates
  • DAYS360 returns days between dates on 360-day year
  • EDATE returns date shifted by given months