Opération GetServerTimeZones
L’opération GetServerTimeZones retourne des informations à partir des définitions de fuseau horaire disponibles sur un serveur Exchange.
En-têtes SOAP
L’opération GetServerTimeZones peut utiliser les en-têtes SOAP répertoriés et décrits dans le tableau suivant.
| Header | Élément | Description |
|---|---|---|
| MailboxCulture |
MailboxCulture |
Identifie la culture RFC3066 à utiliser pour accéder à la boîte aux lettres. |
| RequestVersion |
RequestServerVersion |
Identifie la version du schéma pour la demande d’opération. |
| ServerVersion |
ServerVersionInfo |
Identifie la version du serveur qui a répondu à la requête. |
Exemples de requêtes GetServerTimeZones
Obtention du nom et de l’identificateur de chaque fuseau horaire
L’exemple de code suivant montre comment récupérer le nom et l’identificateur des fuseaux horaires Est Et Pacifique.
Code
<?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>
Comments
Chaque élément Id (TimeZone) contient l’identificateur d’une définition de fuseau horaire demandée. Pour demander des informations pour tous les fuseaux horaires, omettez l’élément Ids de la demande.
Obtention de la définition complète de chaque fuseau horaire
L’exemple de code suivant montre comment récupérer la définition de fuseau horaire complet pour le fuseau horaire standard de l’Est.
Code
<?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>
Comments
Chaque élément Id (TimeZone) contient l’identificateur d’une définition de fuseau horaire demandée. Pour demander des informations pour tous les fuseaux horaires, omettez l’élément Ids de la demande.
Exemples de réponse GetServerTimeZones
Réception du nom et de l’identificateur du fuseau horaire uniquement
L’exemple suivant de réponse GetServerTimeZones montre une réponse réussie à une requête GetServerTimeZones dans laquelle l’attribut ReturnFullTimeZoneData a été défini sur false. La réponse contient le nom et l’identificateur des fuseaux horaires est et heure standard du Pacifique.
Code
<?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>
Réception d’une définition de zone à temps plein
L’exemple suivant de réponse GetServerTimeZones montre une réponse réussie à une requête GetServerTimeZones dans laquelle l’attribut ReturnFullTimeZoneData a été défini sur true. La réponse contient la définition de fuseau horaire complet pour le fuseau horaire standard de l’Est.
Code
<?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>
Voir aussi
GetServerTimeZonesType
Commentaires
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultez https://aka.ms/ContentUserFeedback.
Envoyer et afficher des commentaires pour