GetServerTimeZones 操作
GetServerTimeZones 操作は、サーバー上で使用可能なタイム ゾーン定義から情報をExchangeします。
SOAP ヘッダー
GetServerTimeZones 操作では、次の表に示す SOAP ヘッダーを使用できます。
Header | Element | 説明 |
---|---|---|
MailboxCulture |
MailboxCulture |
メールボックスへのアクセスに使用する RFC3066 カルチャを識別します。 |
RequestVersion |
RequestServerVersion |
操作要求のスキーマ バージョンを識別します。 |
ServerVersion |
ServerVersionInfo |
要求に応答したサーバーのバージョンを識別します。 |
GetServerTimeZones 要求の例
各タイム ゾーンの名前と識別子を取得する
次のコード例は、東部標準時と太平洋標準時のタイム ゾーンの名前と識別子を取得する方法を示しています。
コード
<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:m="https://schemas.microsoft.com/exchange/services/2006/messages"
xmlns:t="https://schemas.microsoft.com/exchange/services/2006/types">
<soap:Header>
<t:RequestServerVersion Version="Exchange2010"/>
</soap:Header>
<soap:Body>
<m:GetServerTimeZones ReturnFullTimeZoneData="false">
<m:Ids>
<t:Id>Eastern Standard Time</Id>
<t:Id>Pacific Standard Time</Id>
</m:Ids>
</m:GetServerTimeZones>
</soap:Body>
</soap:Envelope>
コメント
各 Id (TimeZone) 要素には、要求されているタイム ゾーン定義の識別子が含まれる。 すべてのタイム ゾーンの情報を要求するには、 要求から Ids 要素を省略します。
各タイム ゾーンの完全な定義を取得する
次のコード例は、東部標準時ゾーンの完全なタイム ゾーン定義を取得する方法を示しています。
コード
<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:m="https://schemas.microsoft.com/exchange/services/2006/messages"
xmlns:t="https://schemas.microsoft.com/exchange/services/2006/types">
<soap:Header>
<t:RequestServerVersion Version="Exchange2010"/>
</soap:Header>
<soap:Body>
<m:GetServerTimeZones ReturnFullTimeZoneData="true">
<m:Ids>
<t:Id>Eastern Standard Time</Id>
</m:Ids>
</m:GetServerTimeZones>
</soap:Body>
</soap:Envelope>
コメント
各 Id (TimeZone) 要素には、要求されているタイム ゾーン定義の識別子が含まれる。 すべてのタイム ゾーンの情報を要求するには、 要求から Ids 要素を省略します。
GetServerTimeZones 応答の例
タイム ゾーン名と識別子のみ受け取る
GetServerTimeZones 応答の次の例は 、ReturnFullTimeZoneData 属性が false に設定された GetServerTimeZones 要求に対する正常な応答を示 しています。 応答には、東部標準時と太平洋標準時のタイム ゾーンの名前と識別子が含まれる。
コード
<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:xsd="http://www.w3.org/2001/XMLSchema">
<soap:Header>
<t:ServerVersionInfo MajorVersion="14"
MinorVersion="0"
MajorBuildNumber="639"
MinorBuildNumber="11"
Version="Exchange2010"
xmlns:t="https://schemas.microsoft.com/exchange/services/2006/types" />
</soap:Header>
<soap:Body>
<GetServerTimeZonesResponse xmlns:t="https://schemas.microsoft.com/exchange/services/2006/types"
xmlns:m="https://schemas.microsoft.com/exchange/services/2006/messages">
<m:ResponseMessages>
<m:GetServerTimeZonesResponseMessage ResponseClass="Success">
<m:ResponseCode>NoError</ResponseCode>
<m:TimeZoneDefinitions>
<t:TimeZoneDefinition Id="Eastern Standard Time" Name="(GMT-05:00) Eastern Time (US &amp; Canada)" />
<t:TimeZoneDefinition Id="Pacific Standard Time" Name="(GMT-08:00) Pacific Time (US &amp; Canada)" />
</m:TimeZoneDefinitions>
</m:GetServerTimeZonesResponseMessage>
</m:ResponseMessages>
</m:GetServerTimeZonesResponse>
</soap:Body>
</soap:Envelope>
フル タイム ゾーン定義の受信
GetServerTimeZones 応答の次の例は 、ReturnFullTimeZoneData 属性が true に設定された GetServerTimeZones 要求に対する正常な応答を示 しています。 応答には、東部標準時のタイム ゾーンの完全なタイム ゾーン定義が含まれる。
コード
<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:xsd="http://www.w3.org/2001/XMLSchema">
<soap:Header>
<t:ServerVersionInfo MajorVersion="14"
MinorVersion="0"
MajorBuildNumber="639"
MinorBuildNumber="11"
Version="Exchange2010"
xmlns:t="https://schemas.microsoft.com/exchange/services/2006/types" />
</soap:Header>
<soap:Body>
<GetServerTimeZonesResponse xmlns:t="https://schemas.microsoft.com/exchange/services/2006/types"
xmlns:m="https://schemas.microsoft.com/exchange/services/2006/messages">
<m:ResponseMessages>
<m:GetServerTimeZonesResponseMessage ResponseClass="Success">
<m:ResponseCode>NoError</ResponseCode>
<m:TimeZoneDefinitions>
<t:TimeZoneDefinition Id="Eastern Standard Time" Name="(GMT-05:00) Eastern Time (US &amp; Canada)">
<t:Periods>
<t:Period Bias="PT5H" Name="Standard" Id="trule:Microsoft/Registry/EasternStandardTime/2006-Standard" />
<t:Period Bias="PT4H" Name="Daylight" Id="trule:Microsoft/Registry/EasternStandardTime/2006-Daylight" />
<t:Period Bias="PT5H" Name="Standard" Id="trule:Microsoft/Registry/EasternStandardTime/2007-Standard" />
<t:Period Bias="PT4H" Name="Daylight" Id="trule:Microsoft/Registry/EasternStandardTime/2007-Daylight" />
</t:Periods>
<t:TransitionsGroups>
<t:TransitionsGroup Id="0">
<t:RecurringDayTransition>
<t:To Kind="Period">trule:Microsoft/Registry/EasternStandardTime/2006-Daylight</t:To>
<t:TimeOffset>PT2H</t:TimeOffset>
<t:Month>4</t:Month>
<t:DayOfWeek>Sunday</t:DayOfWeek>
<t:Occurrence>1</t:Occurrence>
</t:RecurringDayTransition>
<t:RecurringDayTransition>
<t:To Kind="Period">trule:Microsoft/Registry/EasternStandardTime/2006-Standard</t:To>
<t:TimeOffset>PT2H</t:TimeOffset>
<t:Month>10</t:Month>
<t:DayOfWeek>Sunday</t:DayOfWeek>
<t:Occurrence>-1</t:Occurrence>
</t:RecurringDayTransition>
</t:TransitionsGroup>
<t:TransitionsGroup Id="1">
<t:RecurringDayTransition>
<t:To Kind="Period">trule:Microsoft/Registry/EasternStandardTime/2007-Daylight</t:To>
<t:TimeOffset>PT2H</t:TimeOffset>
<t:Month>3</t:Month>
<t:DayOfWeek>Sunday</t:DayOfWeek>
<t:Occurrence>2</t:Occurrence>
</t:RecurringDayTransition>
<t:RecurringDayTransition>
<t:To Kind="Period">trule:Microsoft/Registry/EasternStandardTime/2007-Standard</t:To>
<t:TimeOffset>PT2H</t:TimeOffset>
<t:Month>11</t:Month>
<t:DayOfWeek>Sunday</t:DayOfWeek>
<t:Occurrence>1</t:Occurrence>
</t:RecurringDayTransition>
</t:TransitionsGroup>
</t:TransitionsGroups>
<t:Transitions>
<t:Transition>
<t:To Kind="Group">0</t:To>
</t:Transition>
<t:AbsoluteDateTransition>
<t:To Kind="Group">1</t:To>
<t:DateTime>2007-01-01T00:00:00</t:DateTime>
</t:AbsoluteDateTransition>
</t:Transitions>
</t:TimeZoneDefinition>
</m:TimeZoneDefinitions>
</m:GetServerTimeZonesResponseMessage>
</m:ResponseMessages>
</m:GetServerTimeZonesResponse>
</soap:Body>
</soap:Envelope>
関連項目
GetServerTimeZonesType