Compartir a través de

outlookUser: supportedTimeZones

  • Artículo

Espacio de nombres: microsoft.graph

Importante

Las API de la versión /beta de Microsoft Graph están sujetas a cambios. No se admite el uso de estas API en aplicaciones de producción. Para determinar si una API está disponible en la versión 1.0, use el selector de Versión.

Obtener la lista de zonas horarias compatibles con el usuario, según la configuración del servidor de buzones del usuario.

Puede especificar explícitamente que se devuelvan zonas horarias en el formato de zona horaria de Windows o en el formato de zona horaria de la Autoridad de números asignados por Internet (IANA) (también conocido como zona horaria de Olson). El formato Windows es el predeterminado.

Al configurar un cliente de Outlook, el usuario selecciona la zona horaria preferida de esta lista admitida. Posteriormente, puede obtener la zona horaria preferida obteniendo la configuración del buzón del usuario.

Esta API está disponible en las siguientes implementaciones nacionales de nube.

Servicio global Gobierno de EE. UU. L4 Us Government L5 (DOD) China operada por 21Vianet
✅ ✅ ✅ ✅

Permissions

Elija el permiso o los permisos marcados como con privilegios mínimos para esta API. Use un permiso o permisos con privilegios superiores solo si la aplicación lo requiere. Para obtener más información sobre los permisos delegados y de aplicación, consulte Tipos de permisos. Para obtener más información sobre estos permisos, consulte la referencia de permisos.

Tipo de permiso Permisos con privilegios mínimos Permisos con privilegios más altos
Delegado (cuenta profesional o educativa) User.Read User.Read.All, User.ReadBasic.All
Delegado (cuenta personal de Microsoft) User.Read No disponible.
Aplicación No admitida. No admitida.

Solicitud HTTP

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}')

Parámetros de función

Parámetro Tipo Descripción
TimeZoneStandard String Formato de una zona horaria. Los valores admitidos son: Windows y Iana. Opcional.

Encabezados de solicitud

Nombre Tipo Descripción
Authorization string {token} de portador. Obligatorio. Obtenga más información sobre la autenticación y la autorización.

Cuerpo de la solicitud

No proporcione un cuerpo de solicitud para este método.

Respuesta

Si se ejecuta correctamente, este método devuelve un código de respuesta 200 OK y una colección de objetos timeZoneInformation en el cuerpo de la respuesta.

Ejemplo

Solicitud 1

En el ejemplo siguiente no se especifica el parámetro timeZoneStandard y se obtiene la lista de zonas horarias admitidas representadas en el formato de zona horaria de Windows.

GET https://graph.microsoft.com/beta/me/outlook/supportedTimeZones
Respuesta 1

En el ejemplo siguiente se muestra la respuesta.

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

{
  "@odata.context":"https://graph.microsoft.com/beta/$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"
    }
  ]
}
Solicitud 2

En el ejemplo siguiente se especifica el Iana para el parámetro TimeZoneStandard y se obtiene la lista de zonas horarias admitidas representadas en el formato IANA.

GET https://graph.microsoft.com/beta/me/outlook/supportedTimeZones(TimeZoneStandard=microsoft.graph.timeZoneStandard'Iana')
Respuesta 2

En el ejemplo siguiente se muestra la respuesta.

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

{
  "@odata.context":"https://graph.microsoft.com/beta/$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"
    }
  ]
}