Voltar às perguntas frequentes sobre Ferramentas
CENTRAL DE AJUDA · FAQFerramentas1 min de leitura

Como devo tratar datas e fusos horários retornados por uma ferramenta?

Trate timestamps como valores com formato e fuso explícitos, não como textos intercambiáveis. Preserve o valor original quando a precisão importar, converta de forma deliberada para comparar e formate para pessoas somente na apresentação.

Ferramentas

Interprete antes de comparar

Confira se a resposta contém um deslocamento, um fuso nomeado ou nenhuma informação de fuso. Uma data e hora sem fuso pode ser ambígua; não presuma silenciosamente que seja a hora local do agente ou UTC.

Normalize instantes para ordenação e cálculo de duração, mas preserve o fuso original quando ele tiver significado operacional, como um compromisso local ou dia de cobrança. Trate valores somente de data separadamente.

Exiba com contexto

Ao mostrar um horário, identifique o fuso ou torne explícita a preferência regional do usuário. Mudanças de horário podem criar horas locais inexistentes ou repetidas; valide horários agendados próximos a essas transições.

Se o formato da ferramenta não estiver claro, consulte a documentação ou um exemplo de resposta antes de transformar os valores. Teste meia-noite, mudanças de deslocamento e campos sem horário para evitar alterar o dia do evento.

Voltar às perguntas frequentes sobre Ferramentas