19. Datas, horários e fusos

Datas parecem simples até que fusos, horário de verão e medição de duração entram em cena. Representar corretamente o tempo evita execuções adiantadas, atrasadas ou duplicadas.

Este é o capítulo 19 de 25 da apostila Python para Automação e Scripts. Ele aproveita a base construída em HTTP, APIs e integrações e dá mais um passo no desenvolvimento da automação. Ao final, estaremos preparados para estudar Processos, sinais e agendamento.

Começando pela situação real

A partir daqui, a automação ultrapassa seus próprios limites e interage com sistema operacional, bancos, serviços e relógios. Cada integração acrescenta uma nova possibilidade de atraso, indisponibilidade ou efeito parcial. Em Datas, horários e fusos, observaremos como essa parte se liga ao conjunto, mantendo claros o contrato de entrada, o processamento, os efeitos e a conferência do resultado.

Ao ler os exemplos, não tente decorar chamadas isoladas. Pergunte o que entra, qual estado muda, o que sai e como a falha aparece. Essa sequência aproxima a sintaxe do problema que ela resolve e cria uma base que continuará útil quando a biblioteca ou o ambiente mudar.

Datetime aware

O primeiro conceito do capítulo é Datetime aware. Ele fornece a base para interpretar os demais recursos sem confundir o nome de uma ferramenta com o comportamento que ela realmente oferece.

Datetime aware associa data e hora a informação de fuso para representar instantes sem ambiguidade. Em termos simples, essa definição descreve uma promessa feita pelo programa: dadas certas condições, esperamos um comportamento específico. Antes de usar o recurso, identifique essas condições e pense no que deveria acontecer tanto no caminho normal quanto diante de uma entrada inadequada.

Na prática, usar timezone ou zoneinfo e converter nas fronteiras. Transforme essa orientação em passos visíveis: defina a entrada, aplique a operação, observe a saída e registre a condição de sucesso. Assim, o código continua ligado à finalidade da tarefa.

Uma forma de conferir o entendimento é observar o seguinte critério: testes incluem offset, UTC e transição de horário local. Esse critério deve aparecer em um teste, em uma saída controlada ou em outro efeito que possa ser reproduzido.

Zoneinfo

Depois de compreender Datetime aware, podemos avançar para Zoneinfo. As duas ideias se conectam porque uma automação precisa preservar o contrato à medida que os dados percorrem novas etapas.

Zoneinfo fornece fusos IANA e regras históricas disponíveis no sistema ou pacote de dados. Em termos simples, essa definição descreve uma promessa feita pelo programa: dadas certas condições, esperamos um comportamento específico. Antes de usar o recurso, identifique essas condições e pense no que deveria acontecer tanto no caminho normal quanto diante de uma entrada inadequada.