WorkingHours Element

Article
01/20/2015

A user’s working-hours information as specified in the underlying Exchange Server.

calendarData
WorkingHours Element

< WorkingHours xmlns="https://schemas.microsoft.com/exchange/services/2006/types">
    <TimeZone>
        <Bias>Timezone offset from GMT in minutes</Bias>
        <StandardTime>
            <Bias>Timezone offset from GMT in minutes </Bias>
            <Time>Starting time (hh:mm:ss)</Time>
            <DayOrder>integer:[1,4|5]</DayOrder>
            <Month>integer:[1,12]</Month>
            <DayOfWeek>Sunday|Monday|Tuesday|Wednseday|Thursday|Friday|Saturday</DayOfWeek>
        </StandardTime>
        <DaylightTime>
            <Bias>Timezone offset from GMT in minutes</Bias>
            <Time>Starting time (hh:mm:ss)</Time>
            <DayOrder>integer:[1, 4|5]</DayOrder>
            <Month>integer:[1,12]</Month>
            <DayOfWeek>Sunday|Monday|Tuesday|Wednseday|Thursday|Friday|Saturday </DayOfWeek>
        </DaylightTime>
    </TimeZone>
    <WorkingPeriodArray>
        <WorkingPeriod>
            <DayOfWeek>[Sunday[ Monday[ Tuesday[ Wednseday[ Thursday[ Friday [Saturday]]]]]]]</DayOfWeek>
            <StartTimeInMinutes>Minutes starting from the midnight</StartTimeInMinutes>
            <EndTimeInMinutes>Minutes starting from the midnight</EndTimeInMinutes>
        </WorkingPeriod>
    </WorkingPeriodArray>
</WorkingHours>

WorkingHours

Attributes and Elements

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

Attributes

None

Child Elements

Element	Occurrence	Description
calendarData/WorkingHours/TimeZone Element	1	Current time zone of the user’s working hours.
calendarData/WorkingHours/WorkingPeriodArray Element	1	An array of working periods forming the user’s working hours.

Parent Elements

Element	Description
calendarData	calendarData category instance value.

Text Value

None

Remarks

This element is defined in the Microsoft Exchange Service namespace, the name of which is "https://schemas.microsoft.com/exchange/services/2006/types".

Example

The following XML code snippet of a calendarData category instance shows the working hours of a contact (bob@contoso.com) consist of Monday through Friday between 8:00 and 17:00 in the US Pacific Time Zone.

<?xml version="1.0" encoding="utf-8" ?>
<calendarData xmlns="https://schemas.microsoft.com/2006/09/sip/calendarData" mailboxID="bob@contoso.com">
  <WorkingHours xmlns="https://schemas.microsoft.com/exchange/services/2006/types">
    <TimeZone>
      <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>
    <WorkingPeriodArray>
      <WorkingPeriod>
        <DayOfWeek>Monday Tuesday Wednesday Thursday Friday</DayOfWeek>
        <StartTimeInMinutes>480</StartTimeInMinutes>
        <EndTimeInMinutes>1020</EndTimeInMinutes>
      </WorkingPeriod>
    </WorkingPeriodArray>
  </WorkingHours> 
</calendarData>

Microsoft Lync 2010 uses separate calendarData elemenst to specify WorkingHours and freeBusyData, respectively.

Element Information

Namespace	https://schemas.microsoft.com/exchange/services/2006/types
Schema Name	calendarData
Validation File	calendarData.xsd, calendardatatypes.xsd
Can be Empty	True