{"meta":{"title":"Fusos horários e a API REST","intro":"Alguns pontos de extremidade da API REST permitem que você especifique informações de fuso horário com sua solicitação.","product":"API REST","breadcrumbs":[{"href":"/pt/rest","title":"API REST"},{"href":"/pt/rest/using-the-rest-api","title":"Usando a API REST"},{"href":"/pt/rest/using-the-rest-api/timezones-and-the-rest-api","title":"Fusos horários"}],"documentType":"article"},"body":"# Fusos horários e a API REST\n\nAlguns pontos de extremidade da API REST permitem que você especifique informações de fuso horário com sua solicitação.\n\nAlgumas solicitações que criam novos dados, como a criação de um novo commit, permitem fornecer informações de fuso horário ao especificar ou gerar timestamps.\n\nObserve que essas regras se aplicam somente a dados passados para a API, não a dados retornados pela API. Os carimbos de data/hora retornados pela API estão em formato UTC, ISO 8601.\n\n## Determinando o fuso horário de uma solicitação\n\nPara determinar as informações do fuso horário das chamadas de API aplicáveis, empregamos as seguintes regras em ordem de prioridade:\n\n1. [Fornecer explicitamente uma marca de tempo ISO 8601 com informações de fuso horário](#explicitly-providing-an-iso-8601-timestamp-with-timezone-information)\n2. [Usar o cabeçalho `Time-Zone`](#using-the-time-zone-header)\n3. [Usar o último fuso horário conhecido para o usuário](#using-the-last-known-timezone-for-the-user)\n4. [Definir como padrão UTC sem outras informações de fuso horário](#defaulting-to-utc-without-other-timezone-information)\n\n### Fornecer explicitamente uma marca de tempo ISO 8601 com informações de fuso horário\n\nPara chamadas de API que permitem que uma marca de tempo seja especificada, usamos essa marca de tempo exata. Esses timestamps são como `2014-02-27T15:05:06+01:00`.\n\nUm exemplo disso é a API para gerenciar commits. Para saber mais, confira [Pontos de acesso da API REST para commits do Git](/pt/rest/git/commits#create-a-commit).\n\n### Usar o cabeçalho `Time-Zone`\n\nÉ possível fornecer um cabeçalho `Time-Zone` que define um fuso horário de acordo com a [lista de nomes do banco de dados 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\nIsso significa que geramos um carimbo temporal no momento em que sua chamada de API é feita, no fuso horário que esse cabeçalho define.\n\nPor exemplo, a API para gerenciamento de conteúdos gera um commit no Git para cada adição ou alteração e usa a hora atual como timestamp. Para saber mais, confira [Endpoints da API REST para conteúdo de repositório](/pt/rest/repos/contents). O cabeçalho `Time-Zone` determinará o fuso horário usado para gerar este timestamp atual.\n\n### Usar o último fuso horário conhecido para o usuário\n\nSe nenhum cabeçalho `Time-Zone` for especificado e você fizer uma chamada autenticada para a API, nós usaremos o último fuso horário conhecido para o usuário autenticado. Sempre que você navega no site do GitHub, o último fuso horário conhecido é atualizado.\n\n### Definir como padrão UTC sem outras informações de fuso horário\n\nSe as etapas acima não resultarem em nenhuma informação, usaremos UTC como o fuso horário."}