Timestamp Unix para Data

O Timestamp Unix para Data é uma ferramenta gratuita que converte um timestamp Unix em uma data UTC e na data correspondente ao seu fuso horário local.

O que é um timestamp Unix?

Um timestamp Unix é uma contagem numérica do tempo decorrido desde 00:00:00 UTC de 1º de janeiro de 1970, momento conhecido como época Unix. Ele permite que sistemas armazenem e comparem instantes de forma compacta e independente de fuso horário.

Em geral, timestamps Unix contam segundos, embora algumas APIs e linguagens de programação usem milissegundos, microssegundos ou nanossegundos. A unidade não está codificada no próprio número, por isso precisa ser identificada na documentação ou no esquema de dados correspondente. Atualmente, um valor de dez dígitos costuma representar segundos, enquanto um de treze dígitos costuma representar milissegundos. No entanto, a quantidade de dígitos é apenas uma pista útil, não uma garantia formal.

Desenvolvedores frequentemente precisam fazer essa conversão ao ler respostas de APIs de terceiros, inspecionar registros de bancos de dados, verificar entradas de logs ou depurar o cálculo de uma data de expiração. A conversão também é útil antes de uma implantação, quando um arquivo de configuração traz datas de ativação ou expiração de cache e tokens como números inteiros, em vez de datas legíveis.

Como converter um timestamp Unix em data?

Digite o valor numérico em Timestamp Unix e confira os valores convertidos em UTC e Seu fuso horário local. O valor UTC serve como referência estável, enquanto o resultado local mostra como o mesmo instante aparece com o deslocamento do seu fuso horário.

1. Confirme se o valor de origem realmente deve ser interpretado como um timestamp Unix.
2. Verifique se a unidade está em segundos ou em uma unidade menor, como milissegundos.
3. Use o resultado em UTC ao comparar sistemas, logs ou dados de APIs.
4. Use o resultado local para conferir o que uma pessoa teria visto em um relógio ou calendário.

Sempre que possível, informe apenas o número inteiro. Espaços, separadores de milhar, rótulos e sinais de pontuação copiados não fazem parte do formato de um timestamp. Por exemplo, 1,704,067,200 está formatado para facilitar a leitura humana, mas 1704067200 é a forma convencional legível por máquinas. Letras acentuadas e caracteres não latinos não têm significado em um timestamp Unix.

Não há especificação sobre como a ferramenta trata campos vazios, valores decimais, separadores e números extremamente longos. Remova qualquer texto ao redor do número e confirme a unidade antes de considerar a data retornada como definitiva.

Como interpretar os resultados em UTC e no horário local?

Considere o valor UTC como a referência neutra de fuso horário e o valor local como o mesmo momento ajustado ao seu fuso. Eles não representam dois eventos diferentes.

No Reino Unido, o horário local segue o Horário de Greenwich no inverno e o Horário de Verão Britânico no verão. Por isso, um timestamp UTC pode mostrar localmente o mesmo horário no inverno, mas uma hora a mais durante o período de verão. Regras históricas e futuras de fuso horário também podem afetar a exibição local, principalmente fora do Reino Unido.

Se o resultado estiver inesperadamente várias décadas distante da data pretendida, verifique primeiro se houve confusão entre segundos e milissegundos. Se a diferença for de exatamente uma ou várias horas, revise as definições de fuso horário em vez de alterar o timestamp. Uma diferença de um dia costuma ocorrer quando o instante em UTC está próximo da meia-noite e o deslocamento local o leva para o dia anterior ou seguinte.

Uma entrada inválida pode conter letras, rótulos inseridos no valor, um campo vazio ou um número fora do intervalo de datas aceito pelo sistema que o recebe. A mensagem de erro exata e o intervalo numérico compatível com a ferramenta não estão documentados. Portanto, se o resultado não aparecer ou parecer improvável, compare-o com o sistema de origem em vez de tentar adivinhar.

Exemplos de conversão de timestamps

Estes exemplos usam timestamps medidos em segundos inteiros.

Entrada 0

Saída UTC 1 January 1970 at 00:00:00 UTC

O zero marca a época Unix. A exibição local pode ser diferente quando o deslocamento de fuso horário aplicável não for UTC.

Entrada 1704067200

Saída UTC 1 January 2024 at 00:00:00 UTC

No Reino Unido, esse instante ocorre durante o GMT, então o relógio local britânico também marca meia-noite. Em um fuso horário a oeste de UTC, o mesmo timestamp ainda corresponderia a 31 de dezembro de 2023.

Timestamps negativos representam momentos anteriores à época Unix. Por exemplo, -1 normalmente significa um segundo antes da época, ou seja, 31 de dezembro de 1969 às 23:59:59 UTC. A compatibilidade com valores negativos varia entre ambientes de software, bancos de dados e bibliotecas de datas.

Quando não é necessário converter um timestamp?

A conversão não é necessária quando o valor será lido apenas por máquinas e todos os sistemas envolvidos já usam a mesma unidade e a mesma época. Manter o valor numérico evita introduzir datas formatadas que depois possam ser interpretadas com a localidade ou o fuso horário errado.

• Não converta timestamps apenas para comparar a ordem cronológica. Timestamps numéricos na mesma unidade podem ser comparados diretamente.
• Não substitua o timestamp numérico exigido por uma API por uma data formatada, a menos que a especificação permita esse formato.
• Não converta e reinterprete timestamps repetidamente durante o processamento de dados. Preserve o valor original e aplique a formatação apenas na etapa de apresentação.
• Faça a conversão ao depurar um registro desconhecido, conferir uma data de expiração ou revisar dados de terceiros antes da importação.

Uma conversão legível também não comprova que o valor de origem esteja correto. Um erro de digitação no timestamp ainda pode produzir uma data perfeitamente válida. Por isso, compare o resultado com o evento relacionado, a sequência do log ou a documentação da origem.

Perguntas frequentes

Posso usar um timestamp de 13 dígitos?

Atualmente, um timestamp de 13 dígitos geralmente representa milissegundos, e não segundos. Se o conversor espera segundos, primeiro divida o valor em milissegundos por 1,000. Preserve o resto apenas se o destino aceitar frações de segundo. Não há especificação sobre como esta ferramenta trata entradas em milissegundos, então confirme a unidade por outro meio.

O timestamp Unix inclui segundos intercalares?

O tempo Unix padrão não representa segundos intercalares como segundos numerados distintos. Normalmente, os sistemas mapeiam o tempo em uma contagem contínua que considera cada dia como 86,400 segundos Unix, embora o comportamento da sincronização dos relógios possa variar entre plataformas. Em datas comuns de aplicações, isso raramente altera o resultado exibido, mas pode ser relevante em trabalhos especializados de medição do tempo.

O mesmo timestamp gera a mesma data em qualquer lugar?

O timestamp representa o mesmo instante em qualquer lugar, mas a data do calendário e o horário local podem variar conforme o fuso. Um timestamp próximo da meia-noite UTC pode aparecer em datas diferentes em Londres, Nova York e Tóquio. Troque timestamps em UTC entre sistemas e aplique a formatação local apenas na exibição.

Por que a planilha altera meu timestamp?

Planilhas podem exibir valores longos em notação científica ou aplicar uma formatação de data destinada ao sistema próprio de números seriais. Importe a coluna do timestamp como texto ou como número inteiro, desde que a precisão permita, e depois use uma fórmula de conversão explícita. Antes de converter, confirme se a planilha não arredondou os últimos dígitos.

O ano de 2038 é um problema para timestamps Unix?

Pode ser um problema em sistemas que armazenam os segundos Unix como um número inteiro de 32 bits com sinal, cujo intervalo positivo termina em janeiro de 2038. O armazenamento moderno de 64 bits permite um intervalo muito maior, mas bancos de dados antigos, dispositivos embarcados e bibliotecas ainda podem impor o limite mais restrito. Antes da implantação, confira o tipo de armazenamento e a biblioteca de datas usada por todos os sistemas que receberão o valor.