TimeZone (Availability)

Article
03/29/2023

The TimeZone element contains elements that identify time zone information. This element also contains information about the transition between standard time and daylight saving time.

<TimeZone>
   <Bias/>
   <StandardTime/>
   <DaylightTime/>
</TimeZone>

SerializableTimeZone

Attributes and elements

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

Attributes

None.

Child elements

Element	Description
Bias (UTC)	Represents the general offset from Coordinated Universal Time (UTC). This value is in minutes.
StandardTime	Represents an offset from the time relative to UTC represented by the Bias (UTC) element. This element also contains information about the transition to standard time from daylight saving time in regions where daylight saving time is observed.
DaylightTime	Represents an offset from the time relative to UTC represented by the Bias (UTC) element in regions where daylight saving time is observed. This element also contains information about when the transition to daylight saving time from standard time occurs.

Parent elements

Element Description

GetUserAvailabilityRequest Contains the arguments used to obtain user availability information. This is a root element.
The TimeZone element in the GetUserAvailabilityRequest message represents the time zone in which the DateTime values in the request are specified. The DateTime values returned by the Availability service are also in this time zone.
The following is the XPath to this element:
/GetUserAvailabilityRequest

WorkingHours Represents the time zone settings and working hours for the requested mailbox user.
The TimeZone element in the GetUserAvailabilityResponse message represents the time zone settings of the requested mailbox user.
The following is the XPath to this element:
/GetUserAvailabilityResponse/FreeBusyResponseArray/FreeBusyResponse/FreeBusyView/WorkingHours

Element	Description
GetUserAvailabilityRequest	Contains the arguments used to obtain user availability information. This is a root element. The TimeZone element in the GetUserAvailabilityRequest message represents the time zone in which the DateTime values in the request are specified. The DateTime values returned by the Availability service are also in this time zone. The following is the XPath to this element: `/GetUserAvailabilityRequest`
WorkingHours	Represents the time zone settings and working hours for the requested mailbox user. The TimeZone element in the GetUserAvailabilityResponse message represents the time zone settings of the requested mailbox user. The following is the XPath to this element: `/GetUserAvailabilityResponse/FreeBusyResponseArray/FreeBusyResponse/FreeBusyView/WorkingHours`

Remarks

This element is required in the GetUserAvailabilityRequest element. This element occurs at most once or at least zero times when the parent element is the WorkingHours element.

Example

The following example shows part of an XML request that identifies an offset from UTC of 8 hours in the client application.

<TimeZone xmlns="https://schemas.microsoft.com/exchange/services/2006/types">
  <Bias>480</Bias>
  <StandardTime>
    <Bias>0</Bias>
    <Time>02:00:00</Time>
    <DayOrder>1</DayOrder>
    <Month>11</Month>
    <DayOfWeek>Sunday</DayOfWeek>
  </StandardTime>
  <DaylightTime>
    <Bias>-60</Bias>
    <Time>02:00:00</Time>
    <DayOrder>2</DayOrder>
    <Month>3</Month>
    <DayOfWeek>Sunday</DayOfWeek>
  </DaylightTime>
</TimeZone>

Element information

Element	Example
Namespace	https://schemas.microsoft.com/exchange/services/2006/types
Schema Name	Types schema
Validation File	Types.xsd
Can be Empty	False