Skip to main content

Fusos Horários

Fusos horários

O Analytics faz o possível para garantir relatórios precisos no fuso horário que você desejar. Mas fusos horários são criaturas misteriosas.

Configurações de fuso horário

Os seguintes locais onde os fusos horários são configurados podem impactar os dados exibidos:

  • Banco de dados – inclui configurações globais do fuso horário do banco, configurações específicas do tipo de coluna e até mesmo valores individuais.
  • SO & JVM – no sistema onde o Analytics está rodando, as configurações de fuso horário do Sistema Operacional e da Máquina Virtual Java podem influenciar seus relatórios.
  • Analytics – dentro do Analytics, a configuração do fuso horário para relatórios (se definida) influencia como seus dados são apresentados.
  • Analytics Cloud – o fuso horário no servidor que hospeda sua instância do Analytics Cloud.

Configurações recomendadas

Para garantir relatórios corretos, é importante que os fusos horários estejam configurados de forma consistente em todos os locais. O Analytics recomenda as seguintes configurações:

  • Verifique se todas as colunas do seu banco de dados estão configuradas corretamente para incluir consciência de fuso horário.
  • A menos que você tenha uma necessidade especial, é melhor configurar o fuso horário do banco para UTC e armazenar todos os valores de data/hora em UTC.
  • Configure a JVM para usar o mesmo fuso horário que você deseja para os relatórios, o que idealmente também deve coincidir com o fuso horário do banco.
  • Defina o Report Timezone do Analytics para corresponder ao fuso horário que você deseja visualizar nos relatórios; novamente, isso deve coincidir com as demais configurações de fuso horário que realizar.
  • Se quiser alterar o fuso horário do Analytics Cloud, por favor, entre em contato com o suporte.

Tipos de dados

Você pode tornar suas colunas do banco de dados conscientes do fuso horário armazenando-as em tipos de dados específicos, tais como:

Tipo de dado Descrição Exemplo
timestamp with time zone Reconhece localização. 2022-12-28T12:00:00 AT TIME ZONE 'America/Toronto'
timestamp with offset Reconhece a diferença em relação ao UTC. 2022-12-28T12:00:00-04:00
timestamp without time zone Sem informação de fuso horário. 2022-12-28T12:00:00

O tipo exato dependerá do seu banco de dados. Algumas funcionalidades do Analytics funcionam apenas com tipos de dados específicos:

Armérios comuns

  1. O banco de dados utiliza colunas de data/hora sem qualquer informação de fuso horário. Normalmente, quando isso ocorre, o banco assume que todos os dados estão no fuso horário configurado no banco ou, possivelmente, no UTC (verifique a documentação do seu banco para confirmar).
  2. O fuso horário da JVM está diferente da opção Report Timezone configurada no Analytics. Este é um problema muito comum e pode ser corrigido iniciando o java com a opção -Duser.timezone=<timezone> configurada corretamente para coincidir com o fuso horário do relatório no Analytics.

Se você ainda está enfrentando problemas com fusos horários, consulte o guia de resolução de problemas de fusos horários.

Leia a documentação de outras versões do Analytics.

Back to top