DateDifference

DateDifference[date1,date2]

gives the number of days from date1 to date2.

DateDifference[date1,date2,"unit"]

gives the difference between date1 and date2 in the specified unit.

DateDifference[date1,date2,{"unit1","unit2",…}]

gives the difference as a list with elements corresponding to the successive "uniti".

Details and Options

  • DateDifference returns a Quantity object.
  • Dates can be specified in the following forms:
  • DateObject[…]date object
    {y,m,d}year, month, day
    {y,m}the first day of the specified month
    {y}January 1 of the year y
    "string"date as a string ("Jan. 1, 2000")
    {y,m,d,h,m,s}precise time
    timeabsolute time specification
  • Possible units are "Year", "Quarter", "Month", "Week", "Day", "Hour", "Minute", "Second".
  • {y,m,d} is taken to be equivalent to {y,m,d,0,0,0} etc.
  • DateDifference takes the following option:
  • DayCountConvention"ActualActual"counting convention by which the difference is computed
  • DateDifference enumerated in days follows the day count convention, regardless of the magnitude of the difference.
  • DateDifference[date2] gives the fractional number of days from the current time until date2.

Examples

open allclose all

Basic Examples  (4)

Give the number of days between January 1 and July 4:

In[1]:=
Click for copyable input
Out[1]=

Use dates specified in {y,m,d} form:

In[1]:=
Click for copyable input
Out[1]=

Find a date difference in units of weeks:

In[1]:=
Click for copyable input
Out[1]=

If the second date is before the first, the date difference is negative:

In[1]:=
Click for copyable input
Out[1]=

Scope  (6)

Options  (4)

Applications  (2)

Properties & Relations  (1)

Possible Issues  (2)

See Also

DatePlus  DateString  DateList  DateListPlot  DatePattern  DayCount

Introduced in 2007
(6.0)
| Updated in 2014
(10.0)