Este número é um timestamp, que representa a quantidade de tempo decorrida a partir do Unix Epoch (1970-01-01T00:00Z
- 1 de janeiro de 1970 à meia-noite em UTC).
Normalmente usa-se um valor em segundos ou milissegundos, e no seu caso, está em segundos. Ou seja, é um valor que representa 1.444.253.422,348340958 segundos depois do Unix Epoch. (se estivesse em milissegundos, corresponderia a uma data em 1970, então acho mais provável que esteja em segundos mesmo).
Como você quer transformar isso em uma data e hora, há um detalhe que deve levar em conta. O timestamp representa um ponto na linha do tempo: um único instante que é o mesmo no mundo todo. Só que este mesmo instante corresponde a uma data e hora diferentes, dependendo do timezone (fuso-horário). Por exemplo, o timestamp 1444253422.348340958
corresponde aos seguintes dias e horários:
- Em São Paulo: 7 de outubro de 2015, às 18:30:22.348340958
- Em Londres: 7 de outubro de 2015, às 22:30:22.348340958
- Em Tóquio: 8 de outubro de 2015, às 06:30:22.348340958
- Em UTC: 7 de outubro de 2015, às 21:30:22.348340958
Repare que o horário é diferente em cada parte do mundo, e em Tóquio até mesmo o dia é diferente (interessante notar também que em Londres não é o mesmo horário que UTC - um mito comum - pois neste dia a Inglaterra estava em horário de verão).
Portanto, se você quer converter um timestamp para uma data e hora específicas, você precisa saber qual timezone será utilizado.
Módulos datetime
e pytz
Usando o módulo datetime
, é possível converter o timestamp para uma data e hora. E para trabalhar com timezones, sugiro o módulo pytz
, que possui suporte aos timezones da IANA (logo mais explico porque estes são melhores do que usar timedelta
).
Mas antes você precisa transformar a string "1444253422.348340958"
em número. Como não é um número inteiro, podemos usar float
, sem esquecer de capturar o ValueError
caso a string não seja um número.
Em seguida eu uso datetime.fromtimestamp
, passando dois parâmetros:
- o valor do timestamp (e por sorte este método aceita valores "com vírgula", portanto podemos passar o valor do
float
diretamente) - o timezone que será usado para converter o timestamp para uma data e hora específicas
from datetime import datetime
from pytz import timezone
try:
# converter string para número
timestamp = float("1444253422.348340958")
# converter o timestamp para uma data e hora em um timezone específico
dt = datetime.fromtimestamp(timestamp, tz = timezone("Asia/Tokyo"))
print(dt) # 2015-10-08 06:30:22.348341+09:00
# se quiser mostrar em outro formato
print(dt.strftime("%d/%m/%Y %H:%M:%S.%f %z")) # 08/10/2015 06:30:22.348341 +0900
# converter para outro timezone
dt = dt.astimezone(timezone("Europe/London"))
print(dt) # 2015-10-07 22:30:22.348341+01:00
print(dt.strftime("%d/%m/%Y %H:%M:%S.%f %z")) # 07/10/2015 22:30:22.348341 +0100
except ValueError:
print("não foi possível converter o valor do timestamp para um número")
Neste exemplo eu usei Asia/Tokyo
, o que fez com que a data e hora fosse "8 de outubro de 2015 às 06:30.22.348341" (a API possui precisão de microssegundos, ou seja, os 3 últimos dígitos da fração de segundos são perdidos). Em seguida eu converti para Europe/London
, o que mudou tanto o dia quanto a hora. Repare também nos valores +09:00
e +01:00
: estes são os offsets (a diferença com relação a UTC), que no caso indicam que estes horários estão respectivamente 9 horas e 1 hora à frente do UTC.
E se eu não especificar o timezone no método fromtimestamp
?
print(datetime.fromtimestamp(timestamp))
Na minha máquina o resultado foi 2015-10-07 18:30:22.348341
, mas este resultado pode variar de acordo com o timezone default utilizado internamente (no meu caso, pelo valor retornado, parece ser America/Sao_Paulo
- o timezone correspondente ao horário oficial de Brasília). Mas rodando no Ideone.com, por exemplo, o resultado foi 2015-10-07 21:30:22.348341
(pois provavelmente lá o timezone está configurado como UTC).
Por isso é importante passar um timezone específico, pois o timestamp corresponde a uma data e hora diferentes em cada lugar do mundo. Ao usar fromtimestamp
e sem especificar um timezone, você perde o controle sobre a data/hora retornada.
Os nomes de timezones, como America/Sao_Paulo
, Europe/London
e Asia/Tokyo
, seguem o padrão da IANA, e você pode ver a lista completa usando o método all_timezones
:
import pytz
print(pytz.all_timezones)
Isso imprime uma lista com vários nomes (mais de 500), e você pode escolher o mais adequado para a sua situação. Para o horário oficial de Brasília, você pode usar America/Sao_Paulo
(que possui inclusive as regras do horário de verão), mas caso queira o fuso do Nordeste (que atualmente não usa horário de verão) pode usar America/Recife
ou America/Bahia
, por exemplo. A IANA disponibiliza seus arquivos no GitHub, então você também pode consultar todos os timezones do Brasil (todas as linhas que começam com "BR" neste arquivo) e escolher o que precisa.
Não use timedelta
Uma das respostas sugere o uso de timedelta
para subtrair 3 horas e obter o "fuso horário brasileiro". Isso só funciona se fromtimestamp
retornar a data e hora em UTC (o que já vimos que não é garantido se você não especificar o timezone), e se o timestamp corresponde a uma data/hora em que o Brasil não está em horário de verão (pois durante o horário de verão o offset passa a ser de -02:00
, então deveriam ser subtraídas somente 2 horas).
O problema é que é muito difícil determinar o valor exato a ser subtraído de UTC, já que as regras do horário de verão mudam o tempo todo. No Brasil, por exemplo: até 2017, o horário de verão começava no terceiro domingo de outubro, mas a partir de 2018, passou a começar no primeiro domingo de novembro (e será assim "para sempre", ou seja, até que mude de novo).
Além disso, não é todo o país que adota o horário de verão. Atualmente, os estados do Nordeste não adotam, por exemplo, então eles usam o offset -03:00
o ano todo. Já os estados do sudeste usam -03:00
durante parte do ano, e no horário de verão mudam para -02:00
. Mas os estados do centro-oeste usam -03:00
no horário de verão e -04:00
no horário "normal".
Enfim, usar valores fixos de timedelta
é impreciso porque é preciso saber de todas essas regras (se determinada região tem horário de verão, quando começa e termina, quais os offsets usados, etc). E é aí que entra a IANA: ela possui um banco de dados que já tem todo esse histórico e você não precisa se preocupar com isso. Tudo que você precisa é saber o identificador do timezone que quer usar (os nomes America/Sao_Paulo
, Europe/London
, etc).
Usando estes identificadores, como por exemplo America/Sao_Paulo
, ele já saberá se no instante que o timestamp representa, aquela região está ou não em horário de verão e usará o offset correto (sem você precisar "adivinhar" e subtrair/somar timedeltas
arbitrários).
Isso é importante porque estas regras mudam mais do que imaginamos. Atualmente America/Recife
não adota o horário de verão, mas nos anos 80 adotava. E nada garante que isso não mudará no futuro, já que estas regras são definidas por governos/leis e nem sempre com justificativas técnicas. É comum justificativas como "Quero que o povo tenha mais horas de sol", e até mesmo o argumento de economia de energia e demais vantagens e desvantagens é debatido em vários lugares (ou seja, a única certeza que temos é que estas regras mudam o tempo todo).
Por isso há uma grande vantagem em usar o pytz
, pois ele é atualizado conforme a IANA lança novas versões do seu banco, e estas atualizações ficam disponíveis no PyPi.
O uso de timedelta
é uma solução que "parece" certa porque muitos não consideram todas as regras envolvendo timezones, e acham que um valor fixo de offset é o suficiente. Só que um offset não é o mesmo que um timezone: o offset é apenas um valor numérico fixo (a diferença com relação a UTC), enquanto um timezone possui todo o histórico de offsets de uma determinada região (os valores que mudam quando é horário de verão, quando ocorrem estas mudanças, etc). Para mais informações, veja a seção "Diferenças entre timezone e offset" na descrição da tag timezone.