Basic Examples (3) 

Parse a timestamp string in ISO 8601 format:

In[1]:=

Out[1]=

Parse a timestamp with manually-specified granularity:

In[2]:=

Out[2]=

Parse a timestamp describing a dateless time:

In[3]:=

Out[3]=

Scope (5) 

Parse a timestamp in local time:

In[4]:=

Out[4]=

Parse a timestamp in ordinal date format (specifying the number of days since the start of the year):

In[5]:=

Out[5]=

Parse a timestamp describing a week:

In[6]:=

Out[6]=

Parse a list of timestamp strings:

In[7]:=

Out[7]=

Parse a string describing a duration of time:

In[8]:=

Out[8]=

Options (5) 

CalendarType (1) 

Specify a nondefault calendar system to use in the output:

In[9]:=

Out[9]=

DateFormat (1) 

Specify a custom format to display the output in:

In[10]:=

Out[10]=

TimeZone (3) 

By default, timestamps that do not specify a timezone are parsed using the value of $TimeZone:

In[11]:=

Out[11]=

Specify a default timezone to use:

In[12]:=

Out[12]=

Parse to a value explicitly lacking a timezone:

In[13]:=

Out[13]=

Properties and Relations (2) 

DateObject supports limited parsing of ISO 8601-formatted strings:

In[14]:=

Out[14]=

DateObject does not, however, currently support parsing ISO 8601-formatted strings that include a timezone value:

In[15]:=

Out[15]=

FromISOTimestamp supports parsing strings with timezone values:

In[16]:=

Out[16]=

FromISOTimestamp is compatible with the "ISODate", "ISOWeekDate", "ISOOrdinalDate" and "ISODateTime" format specifications of DateString:

In[17]:=

In[18]:=

Out[18]=

In[19]:=

Out[19]=

Possible Issues (9) 

By default, FromISOTimestamp parses ISO 8601-formatted strings containing an integer seconds component with "Seconds" granularity, while DateObject always parses such strings with "Instant" granularity:

In[20]:=

Out[20]=

In[21]:=

Out[21]=

Force FromISOTimestamp to use "Instant" granularity:

In[22]:=

Out[22]=

FromISOTimestamp parses strings containing a fractional seconds component with "Instant" granularity:

In[23]:=

Out[23]=

In[24]:=

Out[24]=

By default, FromISOTimestamp treats times with unspecified timezone as being in local ($TimeZone) time, while TimeObject represents them as explicitly lacking a timezone:

In[25]:=

Out[25]=

In[26]:=

Out[26]=

Set the option TimeZone → None on FromISOTimestamp to output explicitly timezone-less values:

In[27]:=

Out[27]=

In[28]:=

Out[28]=

By default, FromISOTimestamp parses time strings using the granularity implied by the format of the string, while TimeObject always uses "Instant" granularity:

In[29]:=

Out[29]=

Force FromISOTimestamp to use "Instant" granularity:

In[30]:=

Out[30]=

In[31]:=

Out[31]=

"Implied" leading components are not supported by FromISOTimestamp:

In[32]:=

Out[32]=

ISO 8601 treats year 1 BCE as year 0 (and year 2 BCE as year 1, etc.), so negative year values in ISO 8601 timestamps and DateObjects will differ in appearance, although they represent the same dates:

In[33]:=

Out[33]=

DateObject and TimeObject do not support special handling of the leap second, so timestamps including leap seconds will roll over to the next "0" second:

In[34]:=

Out[34]=

In[35]:=

Out[35]=

Certain "basic format" ISO timestamps which can be alternatively parsed as either dates or times are always parsed to dates by FromISOTimestamp:

In[36]:=

Out[36]=

Use “extended format” timestamps to eliminate ambiguity:

In[37]:=

Out[37]=

Alternatively, prefix "basic format" timestamps with the "T" character:

In[38]:=

Out[38]=

"Alternative format" duration strings are not supported:

In[39]:=

Out[39]=

Date/time intervals are not supported:

In[40]:=

Out[40]=

Create an Interval representing a date/time interval from a string in ISO 8601 "start/end" format by splitting at the "/" character:

In[41]:=

Out[41]=