Saltar para o conteúdo
Engenharia

Uma hora a menos, só no verão

04/10/20263 min de leituraRui Pedro Barbosa

As marcações de um cliente apareciam uma hora mais cedo noutro sistema, mas só entre março e outubro. O erro não estava em nenhum relógio.

O cliente tinha dois sistemas ligados por uma API. Num marcavam-se entrevistas, no outro os responsáveis consultavam a agenda. Uma entrevista marcada para as 10:30 aparecia às 09:30 a quem a ia fazer. Já tinha havido candidatos à espera e entrevistadores a chegar uma hora antes.

O erro tinha uma particularidade que o tornava traiçoeiro: no inverno desaparecia sozinho. Por isso tinha sido dado como resolvido mais do que uma vez.

O que não era

A primeira suspeita é sempre o relógio do servidor ou o fuso configurado na aplicação. Verificámos os dois, e estavam certos em todos os sistemas.

A segunda suspeita é a gravação. Também estava certa: a hora chegava como o utilizador a escrevera e era guardada no fuso de Lisboa. O registo de auditoria provava-o.

O problema estava no caminho de volta.

O que era

O sistema que guardava as marcações expunha-as pela API. Ao transformar uma data em texto, a biblioteca usada convertia-a para o tempo universal, o comportamento por omissão. As 10:30 de Lisboa em agosto saíam como 09:30 seguidas de um Z, que significa precisamente "tempo universal".

Do ponto de vista da API, não havia erro. O instante era o mesmo, escrito noutra convenção, e a convenção estava assinalada.

O erro estava em quem lia. O sistema consumidor recebia o texto, extraía a hora e mostrava-a tal como vinha, sem converter para o fuso local. No inverno, Lisboa coincide com o tempo universal e a hora mostrada estava certa. No verão há uma hora de diferença.

A correção que recusámos

A correção rápida, e a que nos foi sugerida, era somar uma hora no ecrã. Resolvia o caso daquela semana e ficava errada no fim de outubro, quando muda a hora. Meio ano depois, o problema voltaria ao contrário, com uma linha de código a somar uma hora sem explicação.

Encontrámos também dois ambientes com o fuso mal configurado em sentidos opostos: um em tempo universal, outro numa hora da Europa central. Em teste, o erro aparecia com o sinal trocado em relação à produção. Quem validasse a correção rápida veria um resultado, e os utilizadores veriam outro.

A correção certa

Mudámos as duas pontas.

Do lado da API, as datas passaram a sair com o desvio explícito do fuso da aplicação. As 10:30 de agosto saem como 10:30 com a indicação de mais uma hora, e em janeiro com a indicação de zero. O instante é o mesmo de antes. Passou a ser legível por uma pessoa e impossível de interpretar mal.

Do lado do consumidor, todas as datas vindas de fora passam por uma única função, que as converte para o fuso local antes de qualquer outra operação. A função aceita os três formatos possíveis: com Z, com desvio, ou sem indicação nenhuma. Deixámos documentado como regra que nenhuma data externa é lida de outra maneira, e alinhámos os fusos dos ambientes de teste com a produção.

O que fica

Um erro que desaparece sozinho é um erro de fuso até prova em contrário. A pergunta útil é "quando é que isto estava certo?". Se a resposta coincide com a mudança da hora, a investigação acabou.

Uma data sem fuso é meia informação. Ao escrever uma API, o desvio vai sempre no texto. Ao ler uma, converte-se sempre, mesmo quando hoje parece desnecessário.

Um ponto único de conversão. A regra só se cumpre se houver uma função com nome e todas as leituras passarem por ela.

Ambientes iguais. Teste e produção com fusos diferentes garantem que os testes mentem.