Date/Time Formats

  • Dates in Hotel Ads XML messages and feeds use the YYYY-MM-DD format.

  • Yearless dates, for events occurring annually, use the MM-DD format.

  • DateTime values follow the RFC 3339 format, including date, time, and timezone information.

  • Time values are expressed as HH:MM[:SS] and are interpreted in the local timezone of the property.

Use the following date/time formats in the Hotel Ads XML messages and feeds.

Date

Dates are expressed in the following format:

YYYY-MM-DD
  • YYYY: Four-digit year
  • MM: Two-digit month
  • DD: Two-digit day

Example: 2017-12-31 for December 31st, 2017.

YearlessDate

Yearless dates express a date event that occurs every year, and are expressed in the following format:

MM-DD
  • MM: Two-digit month
  • DD: Two-digit day

Example: 12-31 for December 31st.

DateTime

DateTime uses the RFC 3339 format:

YYYY-MM-DDTHH:mm[:ss.SSS]+|-HH:mm[Z]
  • YYYY: Four-digit year
  • MM: Two-digit month
  • DD: Two-digit day
  • T: Separates the date from the time
  • HH: Hours
  • mm: Minutes
  • ss: (Optional) Seconds
  • SSS: (Optional) Milliseconds
  • +|-: Separates the date and time from the timezone offset
  • HH:mm: Hours and minutes in the timezone offset
  • Z: (Optional) Zero offset

Example: 2017-12-31T16:20:00-04:00.

You can also specify Z for the timezone offset, which indicates zero offset.

Time

Time is expressed in the format:

HH:MM[:SS]
  • HH: Hours
  • MM: Minutes
  • SS: (Optional) Seconds

Example: 16:20:00 or 16:20.

Times are interpreted in the local time zone of the associated property.