outlookUser: supportedTimeZonesoutlookUser: supportedTimeZones

ユーザーに対してサポートされている (ユーザーのメールボックス サーバーで構成されている) タイム ゾーンのリストを取得します。Get the list of time zones that are supported for the user, as configured on the user's mailbox server.

Windows のタイム ゾーン形式または Internet Assigned Numbers Authority (IANA) のタイム ゾーン (別称: 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. 既定値は Windows 形式です。The Windows format is the default.

Outlook クライアントを設定する際は、このサポートされているリストから、優先するタイム ゾーンを選択します。When setting up an Outlook client, the user selects the preferred time zone from this supported list. これにより、ユーザーのメールボックス設定を取得することによって、優先タイム ゾーンを取得できるようになります。You can subsequently get the preferred time zone by getting the user's mailbox settings.

アクセス許可Permissions

この API を呼び出すには、次のいずれかのアクセス許可が必要です。アクセス許可の選択方法などの詳細については、「アクセス許可」を参照してください。One of the following permissions is required to call this API. To learn more, including how to choose permissions, see Permissions.

アクセス許可の種類Permission type アクセス許可 (特権の小さいものから大きいものへ)Permissions (from least to most privileged)
委任 (職場または学校のアカウント)Delegated (work or school account) User.Read、User.ReadBasic.AllUser.Read, User.ReadBasic.All
委任 (個人用 Microsoft アカウント)Delegated (personal Microsoft account) User.ReadUser.Read
アプリケーションApplication User.Read.AllUser.Read.All

HTTP 要求HTTP 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}')

関数パラメーターFunction parameters

パラメーターParameter Type 説明Description
TimeZoneStandardTimeZoneStandard timeZoneStandardtimeZoneStandard タイム ゾーンの形式。A time zone format. サポートされている値は Windows および Iana です。Supported values are: Windows, and Iana. 省略可能。Optional.

要求ヘッダーRequest headers

名前Name Type 説明Description
AuthorizationAuthorization stringstring ベアラー {トークン}。必須。Bearer {token}. Required.

要求本文Request body

このメソッドには、要求本文を指定しません。Do not supply a request body for this method.

応答Response

成功した場合、このメソッドは 200 OK 応答コードと、応答本文に timeZoneInformation オブジェクトのコレクションを返します。If successful, this method returns 200 OK response code and a collection of timeZoneInformation objects in the response body.

Example

要求 1Request 1

次の例では、timeZoneStandard パラメーターを指定せずに、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
応答 1Response 1

以下は、応答の例です。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"
    }
  ]
}
要求 2Request 2

次の例では、TimeZoneStandard パラメーターに Iana を指定して、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')
応答 2Response 2

以下は、応答の例です。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"
    }
  ]
}