Timezone (Fuso Horario do sistema)
A plataforma pode ser configurada para visualizar as horas em qualquer Timezone
O servidor está configurado SEMPRE para UTC.
O banco de dados grava todas as informações SEMPRE como UTC.
A plataforma pode ser configurada para visualizar as horas em qualquer Timezone (a nível de tenant).
Cada usuario pode ter o seu próprio Timezone para visualizaão dos dados e a plataforma também terá um timezone padrão.
Por exemplo. Se sua equipe está em São Paulo - Brasil e outra em NY - Estados Unidos, vc pode configurar uma timezone padrão para a plataforma, exemplo, America/Sao_Paulo e também pode configurar para que cada usuario visualize a hora de acordo com sua localidade. Independente da forma que visualizará a informação será salva no banco de dados como UTC.
Importante dizer é que no C#, em caso de uso do DateTime.Now ou derivados. A data sempre estará em UTC. Para converter, use a extensão .ToUserTimeZone
Exemplo:
//exemplo: retorna 22/07/2024 22:37:00
var utcDate = DateTime.Now;
//exemplo: caso o TimeZone do user seja America/Sao_Paulo (-3) retornaria 22/07/2024 19:37:00
var userTimezoneDate = DateTime.Now.ToUserTimeZone();
Api e Api User
Nas execuções de API sempre prevalecerá o Timezone definido no momento do cadastrado no User API
Em caso de Api, você pode definir o Timezone da execução no cadastro do Usuario de API, será esse timezone que o sistema considerará ao executar uma API
Acesse o Cadastro de Usuário de Api (Api User) e defina o timezone como na imagem abaixo:
Programação na API com C# (Custom code)
Na Api C#, em caso de uso do DateTime.Now ou derivados. A data sempre estará em UTC. Para converter para a Timezone do User que está executando a API, utilize a extensão .ToUserTimeZone como no exemplo abaixo.
//exemplo: retorna 22/07/2024 22:37:00
var utcDate = DateTime.Now;
//exemplo: caso o TimeZone do user seja America/Sao_Paulo (-3) retornaria 22/07/2024 19:37:00
var userTimezoneDate = DateTime.Now.ToUserTimeZone(); No método C# ApiContext.SaveEntityAsync, o sistema automaticamente irá converter as datas recebidas por parametro para UTC no momento de salvar no banco de dados, então é importante que a API receba a data no Timezone definido nas configurações do Usuário de API. Exemplo:
Se vc tem uma entidaide chamada Tarefa, e nessa tarefa você tem um campo de Data de entrega que vc gostaria que fosse a data 27/12/2024 23:55:55 no horario de São Paulo.
1. Você deve configurar o seu Usuario de API para ter o TimeZone de São Paulo.
2. Você deve mandar a data com o horario 27/12/2024 23:55:55
3. Você não deve se preocupar com a conversão para UTC ao salvar no banco de dados, pois a conversão será feita automaticamente pelo sistema.