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 .
  • The default value of CalendarType is Automatic, which uses the proleptic Gregorian calendar in which there is no year 0. Years prior to the Common Era are negative, and those after are positive.
  • 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.
  • Functions such as Sort, Greater, Max, etc. work with DateObject.

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)
Translate this page: