Perfil e Definições de Fuso Horário

Este documento explica como configurar o teu perfil de utilizador e as definições de fuso horário no Dashboard.PT. Uma configuração correta garante que todas as datas e horas apresentadas na aplicação correspondem ao teu fuso horário local.

Definições do Perfil

O teu Perfil contém informação pessoal e preferências de apresentação que afetam a forma como usas o Dashboard.PT.

Definição Descrição
Nome * O teu nome próprio (obrigatório)
Apelido * O teu apelido (obrigatório)
Email * O teu endereço de email (obrigatório)
Empresa O nome da tua empresa ou organização
Telefone O teu número de telefone de contacto
Morada A tua morada física
Idioma O idioma da interface que preferes (Português ou Inglês)
Fuso Horário O teu fuso horário local para apresentação de datas e horas

Como Aceder às Definições do Perfil

  1. Clica no teu avatar no canto superior direito do ecrã
  2. Seleciona "Perfil" no menu suspenso
  3. Atualiza a tua informação conforme necessário
  4. Clica em "Guardar" para aplicar as alterações

Definições de Fuso Horário

A definição de fuso horário é particularmente importante, pois afeta a forma como as datas e horas são apresentadas em toda a aplicação. Todas as marcas temporais são guardadas em UTC na base de dados, mas serão convertidas para o fuso horário que selecionaste na apresentação.

Porque é que o Fuso Horário Importa

Definir o fuso horário correto garante que:

  • Os teus pontos de dados são apresentados com a hora local correta
  • As análises baseadas em tempo refletem o teu horário de trabalho local
  • Os relatórios agendados são executados nas horas adequadas à tua região
  • Os filtros de data funcionam como esperado no contexto da tua hora local

Opções de Fuso Horário Disponíveis

Fuso Horário Descrição Desvio UTC
Europe/Lisbon Lisboa, Portugal UTC+0/+1 (DST)
Atlantic/Azores Açores, Portugal UTC-1/+0 (DST)
Europe/London Londres, Reino Unido UTC+0/+1 (DST)
Europe/Paris Paris, Berlim, Roma, Madrid UTC+1/+2 (DST)
America/New_York Nova Iorque, EUA (Hora do Leste) UTC-5/-4 (DST)
America/Sao_Paulo São Paulo, Brasil UTC-3
UTC Tempo Universal Coordenado UTC+0

Nota: DST indica que a região observa a Hora de Verão.

Como o Fuso Horário Afeta a Apresentação dos Dados

Quando alteras a definição de fuso horário, todas as marcas temporais apresentadas na interface convertem-se automaticamente para mostrar a hora correta no fuso horário que selecionaste. Isto afeta:

  • As marcas temporais dos dados dos gráficos
  • As horas de atualização dos dashboards
  • As datas de criação e modificação dos pontos de dados
  • As marcas temporais de acionamento dos alertas
  • Os registos do sistema e trilhos de auditoria

Nota Importante

Ao adicionar ou editar pontos de dados manualmente, a hora que introduzes será interpretada como estando no fuso horário que selecionaste. O sistema converte-a automaticamente para UTC para armazenamento.

API e Fusos Horários

Ao trabalhar com a API, é importante perceber como os fusos horários são tratados:

  • Todas as marcas temporais enviadas para a API devem estar no formato ISO 8601 (YYYY-MM-DD HH:MM:SS)
  • A API interpreta sempre as marcas temporais recebidas como UTC, exceto se for especificado explicitamente
  • Todas as marcas temporais devolvidas pela API estão em UTC
  • As aplicações cliente devem converter as marcas temporais para o fuso horário local do utilizador na apresentação

Exemplo de Marca Temporal da API

Exemplo de corpo de pedido para adicionar pontos de dados com marcas temporais:

{
  "graph_id": 123,
  "data": [
    {
      "timestamp": "2023-06-15T14:30:00Z", // O 'Z' indica hora UTC
      "value": 42.5,
      "label": "June Sales"
    },
    {
      "timestamp": "2023-07-15T14:30:00+01:00", // A especificar explicitamente UTC+1
      "value": 47.8,
      "label": "July Sales"
    }
  ]
}

Resolução de Problemas de Fuso Horário

Problema Possível Solução
As horas estão desfasadas por algumas horas Verifica se a tua definição de fuso horário corresponde à tua localização real
Os dados aparecem na data errada Isto pode ocorrer ao atravessar a mudança de dia entre fusos horários; confirma a tua definição de fuso horário
Horas desfasadas em 1 hora após a mudança para a Hora de Verão O sistema trata automaticamente da Hora de Verão; isto pode dever-se a submissões via API com marcas temporais explícitas
Os dados da API e a interface mostram horas diferentes Lembra-te de que a API devolve horas em UTC que precisam de ser convertidas para apresentação

Para assistência adicional com a configuração do fuso horário, contacta support@dashboard.pt.

Quer experimentar? O plano gratuito não tem limite de tempo.

Criar conta gratuita