Common/data/v1.1/TimeZoneInfo

Jump to: navigation, search

TimeZoneInfo

Contains the UTC offset that applies to a television service. You use the UTC offset to calculate local broadcast times because broadcast times are returned in UTC time.

Since UTC offsets can change with daylight savings time (DST), this object contains the time an offset begins and ends. Multiple time zone objects are returned when:

  • The schedule for a location that observes DST crosses a DST change over.
  • The schedule for a location that does not observe DST crosses the calendar year.

The format for date and time is YYYY-MO-DDTHH:MI:SSZ, where:

  • YYYY = year
  • MO   = month     
  • DD   = day
  • HH = hour (00 to 23)
  • MI = minute
  • SS = second

Note that the letter T precedes the time and that, to indicate UTC time, the date-time ends with the letter Z. (UTC time is also known as Zulu time.)

Elements

NameTypeDescription
startDateTime string Date and time when the offset value begins.
endDateTime string Date and time when the offset value ends.
offset integer Value in minutes that the local time is offset from UTC.

The offset may be positive or negative, depending on location (east or west of the Prime Meridian).

XML Response Example

<TimeZoneInfo>
    <startDateTime>2010-11-07T09:00:00Z</StartDateTime>
    <endDateTime>2011-03-13T10:00:00Z</EndDateTime>
    <offset>-480</Offset>
</TimeZoneInfo>

JSON Response Example

{
   "startDateTime":"2010-11-07T09:00:00Z",
   "endDateTime":"2011-03-13T10:00:00Z",
   "offset":"-480"
}
 
Retrieved from "http://prod-doc.rovicorp.com/mashery/index.php/Common/data/v1.1/TimeZoneInfo"
Personal tools