Microsoft Windows SharePoint Services
HomeBackForwardPrint

DATEDIF

DATEDIF

Calculates the number of days, months, or years between two dates. This function is provided for compatibility with Lotus 1-2-3.

Syntax

DATEDIF(start_date,end_date,unit)

Start_date   A date that represents the first, or starting, date of the period. Dates may be entered as text strings within quotation marks (for example, "2001/1/30"), as serial numbers (for example, 36921, which represents January 30, 2001, if you're using the 1900 date system), or as the results of other formulas or functions (for example, DATEVALUE("2001/1/30")).

End_date   A date that represents the last, or ending, date of the period.

Unit   The type of information you want returned:

UnitReturns
"Y"The number of complete years in the period.
"M"The number of complete months in the period.
"D"The number of days in the period.
"MD"The difference between the days in start_date and end_date. The months and years of the dates are ignored.
"YM"The difference between the months in start_date and end_date. The days and years of the dates are ignored
"YD"The difference between the days of start_date and end_date. The years of the dates are ignored.

Remarks

Example

Start_dateEnd_dateFormula Description (Result)
1/1/20011/1/2003DATEDIF(Start_date,End_date,"Y") Two complete years in the period (2)
6/1/20018/15/2002DATEDIF(Start_date,End_date,"D")440 days between June 1, 2001, and August 15, 2002 (440)
6/1/20018/15/2002DATEDIF(Start_date,End_date,"YD")75 days between June 1 and August 15, ignoring the years of the dates (75)
6/1/20018/15/2002DATEDIF(Start_date,End_date,"MD")The difference between 1 and 15 — the day of start_date and the day of end_date — ignoring the months and the years of the dates (14)
©2003 Microsoft Corporation. All rights reserved.