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.

DateObject[{"string",{"e1","e2", }}]
gives the date object obtained by extracting elements from .

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 .
  • In the form DateObject[{"string",{"e1","e2",}}], the can be , , , , , , , , , , , , or .
  • DateObject[{"string",{"e1","e2",}}] uses the to fill in elements of . Those not filled in are taken to have default values , where is the current year.
  • In DateObject[{"string",{"e1","e2",}}], the are extracted from in the order given, and can be separated by any non-alphanumeric characters.
  • DateObject[{"string",{"e1","sep12","e2","sep23",}}] extracts elements using the explicit separators specified.
  • 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 or a time zone string.
  • 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: