Timestamp Unix para Data

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

O que é um timestamp Unix?

Um timestamp Unix é uma contagem numérica do tempo decorrido desde as 00:00:00 UTC de 1 de janeiro de 1970, momento conhecido como época Unix. Permite aos sistemas armazenar e comparar instantes de forma compacta e independente do fuso horário.

Os timestamps Unix contam normalmente segundos, embora algumas APIs e linguagens de programação utilizem milissegundos, microssegundos ou nanossegundos. A unidade não está codificada no próprio número, pelo que tem de ser identificada através da documentação ou do esquema de dados. Atualmente, um valor com dez algarismos corresponde muitas vezes a segundos, enquanto um valor com treze costuma representar milissegundos. No entanto, o número de algarismos é apenas uma pista útil, não uma garantia formal.

Esta conversão é frequentemente necessária ao ler respostas de APIs de terceiros, analisar registos de bases de dados, verificar entradas de logs ou depurar um cálculo de expiração. Também é útil antes de uma implementação, quando um ficheiro de configuração contém datas de ativação ou tempos de expiração de cache ou tokens sob a forma de números inteiros, em vez de datas legíveis.

Como converto um timestamp Unix numa data?

Introduz o valor numérico em Timestamp Unix e consulta depois os valores convertidos em UTC e O teu fuso horário local. O resultado UTC é a referência estável, enquanto o resultado local mostra como esse mesmo instante é apresentado de acordo com a diferença do teu fuso horário.

1. Confirma que o valor de origem corresponde efetivamente a um timestamp Unix.
2. Verifica se a unidade utilizada é segundos ou uma unidade mais pequena, como milissegundos.
3. Usa o resultado UTC ao comparar sistemas, logs ou dados de APIs.
4. Usa o resultado local para confirmar o que uma pessoa teria visto num relógio ou calendário.

Sempre que possível, utiliza apenas o número inteiro. Espaços, separadores de milhares, rótulos e sinais de pontuação copiados não fazem parte do formato do 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 qualquer significado num timestamp Unix.

Não está especificado de que forma a ferramenta processa campos vazios, valores decimais, separadores ou números extremamente longos. Remove todo o texto em redor e confirma a unidade antes de considerares definitiva qualquer data devolvida.

Como devo interpretar os resultados UTC e local?

Interpreta o valor UTC como a referência independente do fuso horário e o valor local como o mesmo momento ajustado ao teu fuso horário. Os dois resultados não representam acontecimentos diferentes.

Em Portugal continental, a hora local segue a hora da Europa Ocidental no inverno e a hora de verão da Europa Ocidental no verão. Assim, um timestamp UTC pode apresentar localmente a mesma hora no inverno, mas uma hora mais tarde durante o período de verão. As regras históricas e futuras dos fusos horários também podem afetar a apresentação local, sobretudo noutras regiões.

Se o resultado estiver inesperadamente afastado várias décadas da data pretendida, verifica primeiro se houve uma confusão entre segundos e milissegundos. Se a diferença for de exatamente uma ou várias horas, analisa os pressupostos relativos ao fuso horário em vez de alterares o timestamp. Uma diferença de um dia ocorre muitas vezes quando o instante UTC está próximo da meia-noite e a diferença horária local o desloca 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 suportado pelo sistema de destino. A mensagem de erro exata e o intervalo numérico suportado pela ferramenta não estão documentados. Por isso, se não houver resultado ou se este parecer implausível, confirma o valor no sistema de origem em vez de tentares adivinhar.

Exemplos de conversão de timestamps

Estes exemplos utilizam timestamps medidos em segundos inteiros.

Entrada 0

Resultado UTC 1 January 1970 at 00:00:00 UTC

O zero assinala a época Unix. A apresentação local pode ser diferente quando a diferença horária aplicável não corresponde a UTC.

Entrada 1704067200

Resultado UTC 1 January 2024 at 00:00:00 UTC

Em Portugal continental, esse instante ocorre durante a hora da Europa Ocidental, pelo que a hora local também é meia-noite. O mesmo timestamp, apresentado num fuso horário a oeste de UTC, ainda corresponderia a 31 de dezembro de 2023.

Os timestamps negativos representam momentos anteriores à época Unix. Por exemplo, -1 significa convencionalmente um segundo antes da época, ou seja, 31 de dezembro de 1969 às 23:59:59 UTC. O suporte de valores negativos varia entre ambientes de software, bases de dados e bibliotecas de datas.

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

A conversão não é necessária quando o valor se destina apenas a ser lido por máquinas e todos os sistemas envolvidos já utilizam a mesma unidade e a mesma época. Manter o valor numérico evita introduzir datas formatadas que possam mais tarde ser interpretadas com a configuração regional ou o fuso horário errados.

• Não convertas timestamps apenas para comparar a respetiva ordem cronológica. Os timestamps numéricos que utilizam a mesma unidade podem ser comparados diretamente.
• Não substituas o timestamp numérico exigido por uma API por uma data formatada, a menos que a especificação permita esse formato.
• Não convertas e voltes a interpretar timestamps repetidamente durante o processamento de dados. Conserva o valor original e aplica a formatação apenas na fase de apresentação.
• Converte um timestamp quando estiveres a depurar um registo desconhecido, a verificar um prazo de expiração ou a analisar dados de terceiros antes da importação.

Uma conversão legível também não prova que o valor de origem esteja correto. Um timestamp introduzido incorretamente pode gerar uma data perfeitamente válida, por isso compara-o com o acontecimento relevante, a sequência dos logs ou a documentação de origem.

Perguntas frequentes

Posso usar um timestamp com 13 algarismos?

Atualmente, um timestamp com 13 algarismos costuma representar milissegundos, não segundos. Se o conversor esperar segundos, divide primeiro o valor em milissegundos por 1.000 e conserva o resto apenas se o destino aceitar frações de segundo. Não está especificado como esta ferramenta processa entradas em milissegundos, pelo que deves confirmar a unidade de forma independente.

Os timestamps Unix incluem segundos intercalares?

O tempo Unix padrão não representa os segundos intercalares como segundos numerados distintos. Normalmente, os sistemas convertem o tempo numa contagem contínua que considera cada dia como tendo 86.400 segundos Unix, embora o comportamento da sincronização dos relógios possa variar entre plataformas. Em datas usadas por aplicações comuns, isto raramente altera o resultado apresentado, mas é relevante em trabalhos especializados de medição do tempo.

O mesmo timestamp dá a mesma data em todo o lado?

O timestamp representa o mesmo instante em qualquer lugar, mas a data do calendário e a hora local podem variar consoante o fuso horário. Um timestamp próximo da meia-noite UTC pode surgir em datas diferentes em Londres, Nova Iorque e Tóquio. Troca timestamps em UTC e aplica a formatação local apenas para apresentação.

Porque é que a folha de cálculo altera o meu timestamp?

As folhas de cálculo podem apresentar valores longos em notação científica ou aplicar uma formatação de data concebida para o seu próprio sistema de números de série. Importa a coluna de timestamps como texto ou como números inteiros, se a precisão o permitir, e utiliza depois uma fórmula de conversão explícita. Antes da conversão, confirma que a folha de cálculo não arredondou os últimos algarismos.

O ano de 2038 é um problema para os timestamps Unix?

Pode ser um problema em sistemas que armazenem os segundos Unix como números inteiros de 32 bits com sinal, cujo intervalo positivo termina em janeiro de 2038. O armazenamento moderno de 64 bits permite um intervalo muito mais amplo, mas bases de dados antigas, dispositivos integrados e algumas bibliotecas ainda podem impor o limite mais reduzido. Antes da implementação, verifica o tipo de armazenamento e a biblioteca de datas utilizados por todos os sistemas que recebem o valor.