V9.Common:TimeZoneInfo

Jump to: navigation, search

TimeZoneInfo

Contains UTC offset information that applies to a television service.

Television program times are returned in Coordinated Universal Time (UTC). To determine the local time of a program, you need to apply the UTC offset to the returned time.

UTC offsets change when local daylight savings time starts and ends.

  • For a time zone that observes daylight savings time (DST), two TimeZoneInfo objects are returned when the duration crosses a DST change over. The end date of one and start date of another delineate the DST boundary.
  • For a time zone that does not observe daylight savings time, the UTC offset does not change and TimeZoneInfo objects cover January 1st to January 1st. When the duration crosses the first day of the year, two such TimeZoneInfo objects are returned.

Only last, current, and next year are supported. So a start time of two years back or forward will not return time zone information.

Elements

NameTypeDescription
StartDateTime DateTime Offset value start date.
EndDateTime DateTime Offset value end date.
Offset Integer Value in minutes that the local time is offset from GMT. May be a positive or negative offset.

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

JSON responses are available from our REST TV Listings service.
"TimeZoneInfo":{
   "StartDateTime":"2010-11-07T09:00:00Z",
   "EndDateTime":"2011-03-13T10:00:00Z",
   "Offset":"-480"
}
 
Personal tools