A ISO 8601 timestamp in local time.

The following are valid timestamps:

  • 2004-02-12T15:19:21Z
  • 2004-02-12T15:19:21+05:00
  • 2004-02-12T15:19:21-05:00
  • 2004-02-12T15:19:21-05
  • 2004-02-12T15:19:21
  • 2004-02-12T15:19
  • 2004-02-12

If the timezone offset and the UTC identifier (‘Z’) are omitted, the timestamp is assumed to be in local time for the area or point of observation.

Not all features of ISO 8601 are not supported. Specifically, the month digits are required and can not be replace with weeks or 3-digit days. Also since our largest period is a day, timestamps should not be provided for longer periods. As such, the following timestamps are invalid:

  • 2004-W06-2
  • 2004-035
  • 2004-02
  • 2004

The timestamp for a period is represented by the beginning timestamp for that period. For the period of day, the timestamp is set to midnight (00:00:00) at the beginning of the 24 hour period. For the period of hour (suppose the hour occurring between 8 and 9 a.m.), the timestamp is used for the top of the hour (08:00:00).

Returned Value Units: ISO 8601 timestamp
Resource Family: Astronomical Data, Climatological Data, Forecast, Weather History
API Versions: v1