Como converter um timestamp Unix em data e hora

Antes de começar

Este conversor serve para passar de um timestamp Unix para representações de data e hora ou para transformar uma data escrita num timestamp Unix. É adequado quando recebe um valor numérico de um sistema e precisa de o consultar como calendário, quando quer comparar registos temporais ou quando necessita de preparar uma data para uma integração. O modo predefinido trata a entrada como timestamp; o modo alternativo interpreta uma data em texto e calcula o timestamp correspondente.

Procedimento de conversão

1. Para obter uma data a partir de um timestamp, deixe selecionado o modo predefinido e introduza o valor no campo de entrada. Um número inteiro pode ser fornecido diretamente, enquanto um valor em texto também é aceite; texto decimal pode ser interpretado como um timestamp fracionário.
2. Confirme a unidade usada pelo valor recebido. Um timestamp superior a 1 000 000 000 000 é tratado como milissegundos e dividido por 1 000 antes da conversão. Um valor que não ultrapasse esse limiar é tratado como segundos.
3. Execute a operação e leia as representações apresentadas. O resultado bem-sucedido inclui uma data e hora em UTC, uma representação local e outras formas de mostrar a data, a hora, o dia da semana, os segundos e os milissegundos.
4. Para fazer a conversão inversa, selecione o modo destinado a converter uma data em timestamp e escreva a entrada num padrão reconhecido. São aceites YYYY-MM-DDTHH:MM:SS, esse padrão com Z no fim, YYYY-MM-DD HH:MM:SS, YYYY-MM-DD, DD.MM.YYYY HH:MM:SS, DD.MM.YYYY, MM/DD/YYYY HH:MM:SS, MM/DD/YYYY, DD Month YYYY, DD Mon YYYY e YYYY/MM/DD.
5. Submeta a entrada e verifique o estado devolvido. Um campo vazio, um timestamp inválido ou uma data que não corresponda aos padrões reconhecidos não produz uma conversão bem-sucedida, pelo que deve corrigir o valor antes de utilizar qualquer resultado.

Leitura dos resultados

Na conversão de timestamp, a representação UTC é uma referência diferente da representação local. Compare ambas antes de escolher um valor para um relatório, uma análise ou uma integração, sobretudo quando os dados podem ser lidos em ambientes com configurações diferentes. A hora local apresentada depende do ambiente em que a operação é executada.

Na conversão de uma data para timestamp, o texto é interpretado sem informação de fuso horário e o cálculo usa o fuso horário local do ambiente. Assim, a mesma data escrita pode não corresponder ao mesmo timestamp em ambientes com fusos locais diferentes. O Z aceite num dos padrões é apenas um marcador literal desse formato; a sua presença não estabelece, por si só, uma interpretação com fuso horário explícito.

Se o resultado for utilizado fora do conversor, conserve a indicação sobre a origem do timestamp e decida previamente se o processo seguinte deve usar UTC ou a representação local. Quando a entrada não inclui fuso horário, trate o valor calculado como dependente do ambiente, em vez de lhe atribuir uma zona universal.

Exemplo prático

Precisa de interpretar o timestamp Unix 1700000000 antes de o incluir num relatório de atividade.

Introduza 1700000000 no modo predefinido de conversão de timestamp e execute a operação.

A resposta deve indicar uma conversão bem-sucedida e apresentar representações UTC e locais, além de valores formatados para data, hora, dia da semana, segundos e milissegundos.

Limitações

• A conversão de datas aceita apenas os padrões reconhecidos, e os resultados locais ou calculados a partir de datas sem fuso horário explícito dependem do ambiente. Entradas vazias, timestamps inválidos e datas não reconhecidas não geram uma conversão bem-sucedida.

Erros comuns

• Uma causa de falha é escrever a data com uma ordem, separador ou componente de hora que não pertence aos padrões reconhecidos. Compare a entrada com uma das formas suportadas e volte a submetê-la depois de corrigir esses elementos.

Perguntas frequentes

Posso introduzir um timestamp em milissegundos?

Quando o valor é superior a 1 000 000 000 000, a entrada é tratada como milissegundos e convertida dividindo-a por 1 000; os valores abaixo desse limiar são tratados como segundos. O conteúdo pode ser apresentado como número inteiro ou texto, e texto decimal também pode representar uma fração de timestamp.

Posso escrever a data em qualquer formato?

O modo de conversão de data aceita apenas os padrões reconhecidos, como YYYY-MM-DD e YYYY-MM-DDTHH:MM:SS. Uma forma diferente, uma entrada vazia ou um texto que não seja interpretado por esses padrões conduz a um resultado sem conversão bem-sucedida.

O resultado usa sempre o mesmo fuso horário?

A representação local varia conforme o ambiente, e uma data sem fuso horário explícito é convertida usando o fuso horário local desse ambiente. O Z previsto num padrão é um marcador literal, não uma indicação suficiente de que o texto foi analisado como data com fuso horário.