{"meta":{"title":"Fuseaux horaires et API REST","intro":"Certains points de terminaison d’API REST vous permettent de spécifier des informations de fuseau horaire avec votre demande.","product":"API REST","breadcrumbs":[{"href":"/fr/rest","title":"API REST"},{"href":"/fr/rest/using-the-rest-api","title":"En utilisant l’API REST"},{"href":"/fr/rest/using-the-rest-api/timezones-and-the-rest-api","title":"Fuseaux horaires"}],"documentType":"article"},"body":"# Fuseaux horaires et API REST\n\nCertains points de terminaison d’API REST vous permettent de spécifier des informations de fuseau horaire avec votre demande.\n\nCertaines demandes qui créent de nouvelles données, par exemple une validation, vous permettent de fournir des informations de fuseau horaire lorsque vous spécifiez ou générez des horodatages.\n\nNotez que ces règles s’appliquent uniquement aux données transmises à l’API, et non aux données retournées par celle-ci. Les horodatages retournés par l’API sont au format UTC ISO 8601.\n\n## Déterminer un fuseau horaire pour une demande\n\nPour déterminer les informations relatives au fuseau horaire pour les appels API applicables, nous appliquons ces règles par ordre de priorité :\n\n1. ```\n          [Indication explicite d’un horodatage ISO 8601 avec des informations de fuseau horaire](#explicitly-providing-an-iso-8601-timestamp-with-timezone-information)\n   ```\n2. ```\n          [Utilisation de l’en-tête `Time-Zone`](#using-the-time-zone-header)\n   ```\n3. ```\n          [Utilisation du dernier fuseau horaire connu pour l’utilisateur](#using-the-last-known-timezone-for-the-user)\n   ```\n4. ```\n          [Application de la valeur par défaut UTC sans autres informations de fuseau horaire](#defaulting-to-utc-without-other-timezone-information)\n   ```\n\n### Indication explicite d’un horodatage ISO 8601 avec des informations de fuseau horaire\n\nDans le cas des appels d’API qui autorisent la spécification d’un horodatage, nous utilisons cet horodatage précis. Ces horodatages se présentent ainsi : `2014-02-27T15:05:06+01:00`.\n\nL’API qui permet de gérer les commits en est un exemple. Pour plus d’informations, consultez « [Points de terminaison d’API REST pour les commits Git](/fr/rest/git/commits#create-a-commit) ».\n\n### Utilisation de l’en-tête `Time-Zone`\n\nIl est possible de fournir un en-tête `Time-Zone`, qui définit un fuseau horaire en fonction de la [liste des noms de la base de données Olson](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones).\n\n```shell\ncurl -H \"Time-Zone: Europe/Amsterdam\" -X POST https://api.github.com/repos/github-linguist/linguist/contents/new_file.md\n```\n\nCela signifie qu’un horodatage est généré pour le moment où l’appel d’API est effectué, dans le fuseau horaire défini par cet en-tête.\n\nPar exemple, l’API qui permet de gérer les contenus génère une validation Git pour chaque ajout ou modification et elle utilise l’heure actuelle comme horodatage. Pour plus d’informations, consultez « [Points de terminaison d’API REST pour les contenus du référentiel](/fr/rest/repos/contents) ». L’en-tête `Time-Zone` détermine le fuseau horaire utilisé pour générer cet horodatage actuel.\n\n### Utilisation du dernier fuseau horaire connu pour l’utilisateur\n\nSi aucun en-tête `Time-Zone` n’est spécifié lorsque vous effectuez un appel authentifié à l’API, le fuseau horaire utilisé est le dernier fuseau connu de l’utilisateur authentifié. La dernière zone horaire connue est mise à jour chaque fois que vous naviguez sur le site web GitHub.\n\n### Application de la valeur par défaut UTC sans autres informations de fuseau horaire\n\nSi la procédure ci-dessus ne produit aucune information, c’est le fuseau horaire UTC qui est utilisé."}