DateObject

DateObject[]
represents the current local date.

DateObject[date,time]
represents the specified date list and TimeObject time.

DateObject[time]
gives a date object corresponding to an AbsoluteTime specification.

DateObject[{y,m,d,h,m,s}]
represents a date object of standard normalized form.

DateObject["string"]
converts a date string to a date object.

Details and OptionsDetails and Options

  • DateObject[] uses whatever date and time have been set on your computer system by default.
  • DateObject[{y,m,d,h,m,s}] is canonicalized to DateObject[{y,m,d},TimeObject[{h,m,s}], where values of m, d, h, m, s outside their normal ranges are appropriately reduced.
  • Shorter lists can be used in DateObject[{y,m,}], which represents the date to whatever accuracy is specified: {y} is not treated as being equivalent to .
  • DateObject allows addition and subtraction of time quantities.
  • Subtracting two DateObject constructs yields a time quantity.
  • The following options can be given:
  • CalendarTypeAutomaticcalendar system being used
    DateFormat$DateStringFormatformat used to display date
    TimeZone$TimeZonetime zone being used
  • Possible CalendarType specifications are: Automatic, , , , and .
  • TimeZone specifications should be a numerical offset from GMT.
  • With a typical value for $DateStringFormat, the display of DateObject[{y,m,d,h,m,s}] will truncate fractional seconds.

ExamplesExamplesopen allclose all

Basic Examples  (4)Basic Examples  (4)

Find the current date:

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

Convert an absolute time to a date object:

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

Represent a specific year and month:

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

Add 1000 weeks to a date:

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

Subtract two dates to get a time quantity:

In[2]:=
Click for copyable input
Out[2]=
Introduced in 2014
(10.0)