outlookUser : supportedTimeZonesoutlookUser: supportedTimeZones

Espace de noms : microsoft.graphNamespace: microsoft.graph

Obtenez la liste des fuseaux horaires pris en charge pour l’utilisateur, comme configuré sur le serveur de boîte aux lettres de l’utilisateur.Get the list of time zones that are supported for the user, as configured on the user's mailbox server.

Vous pouvez spécifier explicitement que les fuseaux horaires doivent être renvoyés au format de fuseau horaire Windows ou IANA (Internet Assigned Numbers Authority), également appelé fuseau horaire Olson.You can explicitly specify to have time zones returned in the Windows time zone format or Internet Assigned Numbers Authority (IANA) time zone (also known as Olson time zone) format. Le format Windows est défini par défaut.The Windows format is the default.

Lorsque vous configurez un client Outlook, l’utilisateur sélectionne le fuseau horaire par défaut à partir de cette liste prise en charge.When setting up an Outlook client, the user selects the preferred time zone from this supported list. Vous pouvez obtenir par la suite le fuseau horaire par défaut en obtenant les paramètres de boîte aux lettres de l’utilisateur.You can subsequently get the preferred time zone by getting the user's mailbox settings.

AutorisationsPermissions

L’une des autorisations suivantes est nécessaire pour appeler cette API. Pour plus d’informations, notamment sur la façon de choisir les autorisations, voir Autorisations.One of the following permissions is required to call this API. To learn more, including how to choose permissions, see Permissions.

Type d’autorisationPermission type Autorisations (de celle qui offre le plus de privilèges à celle qui en offre le moins)Permissions (from least to most privileged)
Déléguée (compte professionnel ou scolaire)Delegated (work or school account) User.Read, User.ReadBasic.AllUser.Read, User.ReadBasic.All
Déléguée (compte Microsoft personnel)Delegated (personal Microsoft account) User.ReadUser.Read
ApplicationApplication User.Read.AllUser.Read.All

Requête HTTPHTTP request

GET /me/outlook/supportedTimeZones
GET /users/{id|userPrincipalName}/outlook/supportedTimeZones

GET /me/outlook/supportedTimeZones(TimeZoneStandard=microsoft.graph.timeZoneStandard'{timezone_format}')
GET /users/{id|userPrincipalName}/outlook/supportedTimeZones(TimeZoneStandard=microsoft.graph.timeZoneStandard'{timezone_format}')

Paramètres de fonctionFunction parameters

ParamètreParameter TypeType DescriptionDescription
TimeZoneStandardTimeZoneStandard timeZoneStandardtimeZoneStandard Format de fuseau horaire.A time zone format. Les valeurs prises en charge sont : Windows et Iana.Supported values are: Windows, and Iana. Facultatif.Optional.

En-têtes de demandeRequest headers

NomName TypeType DescriptionDescription
AutorisationAuthorization stringstring Porteur {token}. Obligatoire.Bearer {token}. Required.

Corps de la demandeRequest body

N’indiquez pas le corps de la demande pour cette méthode.Do not supply a request body for this method.

RéponseResponse

Si elle réussit, cette méthode renvoie un code de réponse 200 OK et une collection d’objets timeZoneInformation dans le corps de la réponse.If successful, this method returns 200 OK response code and a collection of timeZoneInformation objects in the response body.

ExempleExample

Demande 1Request 1

L’exemple suivant ne spécifie pas le paramètre timeZoneStandard et obtient la liste des fuseaux horaires pris en charge représentés au format de fuseau horaire de Windows.The following example does not specify the timeZoneStandard parameter, and gets the list of supported time zones represented in the Windows time zone format.

GET https://graph.microsoft.com/v1.0/me/outlook/supportedTimeZones
Réponse 1Response 1

Voici un exemple de réponse.Here is an example of the response.

HTTP/1.1 200 OK
Content-type: application/json

{
  "@odata.context":"https://graph.microsoft.com/v1.0/$metadata#Collection(microsoft.graph.timeZoneInformation)",
  "value":[
    {
      "alias":"Dateline Standard Time",
      "displayName":"(UTC-12:00) International Date Line West"
    },
    {
      "alias":"Samoa Standard Time",
      "displayName":"(UTC+13:00) Samoa"
    },
    {
       "alias":"UTC-11",
       "displayName":"(UTC-11:00) Coordinated Universal Time-11"
    },
    {
      "alias":"Aleutian Standard Time",
      "displayName":"(UTC-10:00) Aleutian Islands"
    }
  ]
}
Demande 2Request 2

L’exemple suivant indique la valeur Iana pour le paramètre TimeZoneStandard et obtient la liste des fuseaux horaires pris en charge représentés au format IANA.The following example specifies Iana for the TimeZoneStandard parameter, and gets the list of supported time zones represented in IANA format.

GET https://graph.microsoft.com/v1.0/me/outlook/supportedTimeZones(TimeZoneStandard=microsoft.graph.timeZoneStandard'Iana')
Réponse 2Response 2

Voici un exemple de réponse.Here is an example of the response.

HTTP/1.1 200 OK
Content-type: application/json

{
  "@odata.context":"https://graph.microsoft.com/v1.0/$metadata#Collection(microsoft.graph.timeZoneInformation)",
  "value":[
    {
      "alias":"Etc/GMT+12",
      "displayName":"Etc/GMT+12"
    },
    {
      "alias":"US/Samoa",
      "displayName":"US/Samoa"
    },
    {
      "alias":"Etc/GMT+11",
      "displayName":"Etc/GMT+11"
    },
    {
      "alias":"US/Aleutian",
      "displayName":"US/Aleutian"
    }
  ]
}