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 "ei" from "string".

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 {y,1,1,0,0,0}.
  • In the form DateObject[{"string",{"e1","e2",}}], the "ei" can be "Year", "YearShort", "Quarter", "Month", "MonthName", "Day", "DayName", "Hour", "Hour12", "AMPM", "Minute", "Second", or "Millisecond".
  • DateObject[{"string",{"e1","e2",}}] uses the "ei" to fill in elements of {y,m,d,h,m,s}. Those not filled in are taken to have default values {yc,1,1,0,0,0}, where yc is the current year.
  • In DateObject[{"string",{"e1","e2",}}], the "ei" are extracted from "string" 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, "Gregorian", "Julian", "Jewish", and "Islamic".
  • 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.
  • For an image with Exif date time information, DateObject[image] returns that information as a DateObject[date,time}] object.
  • 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]=

Or represent just a year:

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

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)
| Updated in 2016
(11.0)
Translate this page: