TimeZone Element

This content is no longer actively maintained. It is provided as is, for anyone who may still be using these technologies, with no warranties or claims of accuracy with regard to the most recent product version or service release.

Defines the properties of a time zone.

Syntax

<TimeZone
    id = "string"
    name = "string"
    utcOffset = "decimal"
    dstOffset = "decimal">
</TimeZone>

The following sections describe attributes, parent elements, and child elements.

Attributes

Name

Description

id

string type. Length range 1-255 characters.

Specifies the identifier for the time zone that should be used in the API, for example America/Los_Angeles. This value is used in the timeZone attributes of Meeting elements, and in timeZone options.

name

string type. Length range 1-255 characters.

Represents a more descriptive name for the time zone intended for users, for example, Mountain Standard Time.

utcOffset

decimal type. Value range -1439 to 1439.

Specifies the offset of this time zone from UTC, in minutes, when the time zone is not observing daylight savings time. This is the number of minutes to add to UTC to get the equivalent time in this time zone. For example, for the America/New_York time zone, this is -300 (minus 300 minutes or 5 hours before UTC time).

dstOffset

decimal type. Value range 0-1439.

Specifies the amount of time, in minutes, by which clocks are advanced when daylight savings time or summer time is in effect in this time zone. If the time zone does not observe daylight savings time, the value is zero. For example, for the America/New_York time zone, this is 60.

Element Information

Parent Element

Element

Occurrence

ListTimeZonesReply

1

Child Element

Element

Occurrence

None

Not applicable

Remarks

To find the set of time zones currently in use in a conference center, use the ListTimeZones message.

The purpose of the utcOffset and dstOffset attributes is to distinguish between the different time zones and regions within the time zones. For example, the time zone with id value Europe/Amsterdam represents the Central European time zone. The country The Netherlands (capital: Amsterdam) observes daylight savings time from March through October, so Europe/Amsterdam has a dstOffset value of 60. By contrast, the time zone with id value Asia/Tokyo represents the time zone of the country Japan. Japan does not observe daylight savings time, so Asia/Tokyo has a dstOffsetvalue of zero.

The values of the utcOffset and dstOffset attributes are not intended for use by software that converts between UTC and local time.

Time zones are included in the API for use in the user interface and for sending invitations to meetings. All times in the API are in UTC, even when a time zone is specified.

See Also

Concepts

ListTimeZonesReply Element