Comportamento e formato da coluna de Data e Hora

No Microsoft Dataverse, o tipo de dados Data e Hora é usado em muitas colunas da tabela padrão. Dependendo do tipo de data que a coluna exibir, você poderá escolher vários comportamentos de coluna diferentes: Local do Usuário, Somente Data ou Independente de Fuso Horário.

Comportamento e formato da coluna de data e hora

A tabela a seguir contém informações sobre comportamento e o formato da coluna de data e hora.

Comportamento	Formatar	Descrição
Local do Usuário	Somente Data - ou - Data e Hora	Este é o comportamento padrão das colunas de data e hora. Os valores de coluna são exibidos na hora local do usuário atual. Em serviços Web, esses valores são retornados usando o formato de fuso horário UTC comum. É possível mudar isso depois que você selecionar o comportamento padrão. Mais informações Alteração do comportamento do Local do Usuário
Somente Data	Somente Data	Sem conversão de fuso horário. A parte de hora do valor sempre será 00:00. A parte de data do valor é armazenada e recuperada como especificado na IU e nos serviços Web.
Independente de Fuso Horário	Somente Data - ou - Data e Hora	Sem conversão de fuso horário. Os valores de data e hora são armazenados e recuperados como especificado na IU e nos serviços Web.

Alteração do comportamento do Local do Usuário:

Exceto se o editor de uma solução gerenciada bloquear essa opção, você pode mudar o comportamento das colunas personalizadas de Data de Local do Usuário para Somente Data ou Independente de Fuso Horário. Essa alteração só pode ser feita uma vez.

A alteração do comportamento da coluna afeta os valores da coluna adicionados ou modificados após a alteração do comportamento da coluna. Os valores de coluna existentes permanecem no banco de dados no formato de fuso horário UTC. Para alterar o comportamento dos valores de coluna existentes de UTC para Somente Data, talvez você precise da ajuda de um desenvolvedor para fazer isso programaticamente. Mais informações: Converter o comportamento de valores existentes de data e hora no banco de dados.

Aviso

Antes de mudar o comportamento de uma coluna existente de data e hora, revise todas as dependências dela, como regras de negócios, fluxos de trabalho, colunas calculadas ou colunas cumulativas, para garantir que não haverá problemas como resultado da alteração no comportamento. Depois de alterar o comportamento de uma coluna de data e hora, será necessário abrir cada regra de negócios, fluxo de trabalho, coluna calculada e coluna cumulativa dependente da coluna alterada, examinar as informações e salvá-la para garantir que o comportamento e o valor da coluna de data e hora mais recentes estejam sendo usados.

Alteração do comportamento durante a importação de uma solução

Quando você importa uma solução que contém uma coluna de Data com o comportamento Local do Usuário, você tem a opção de mudar esse comportamento para Somente Data ou Independente de Fuso Horário.

Bloqueio da alteração de comportamento

Ao distribuir uma coluna personalizada de data em uma solução gerenciada, você poderá evitar que os usuários da sua solução mudem o comportamento. Para isso, basta definir a propriedade gerenciada CanChangeDateTimeBehavior como Falsa. Mais informações: Definir propriedades gerenciadas para colunas

Casos de uso

Considere os seguintes casos de uso para os comportamentos Somente Data e Independente de Fuso Horário.

Cenário Somente Data: aniversários e datas especiais

O comportamento de Somente Data é bom para casos quando as informações sobre a hora do dia e o fuso horário não são necessárias, como em aniversários ou em aniversários de casamento. Com essa seleção, todos os usuários do aplicativo no mundo inteiro verão o mesmo valor exato de data.

Cenário Independente de Fuso Horário: check-in em hotel

Você poderá usar esse comportamento quando as informações de fuso horário não forem necessárias, como o horário de check-in do hotel. Com essa seleção, todos os usuários do aplicativo no mundo inteiro verão o mesmo valor de data e hora.

Práticas recomendadas para usar o fuso horário

Para minha coluna Data/Hora, eu esperava (UTC/local) e estou vendo o valor oposto

Isso é causado por uma falta de paridade entre a configuração da coluna da tabela e a configuração do formulário do aplicativo. Quando uma coluna da tabela é configurada para Independente de Fuso Horário ou Local do Usuário, ela determina se a diferença de fuso horário é respeitada ou não quando os dados estão sendo recuperados da loja. No entanto, o formulário do aplicativo também possui uma configuração UTC ou Local.

Isso informa ao formulário como interpretar os dados que recebe do Dataverse. Se os dados recuperados da loja forem independentes do fuso horário, mas o formulário estiver definido como local, os dados UTC serão exibidos como horário local do usuário com base no fuso horário do usuário em seu perfil. O inverso também é verdadeiro, um valor local do usuário da loja será exibido como UTC se o formulário estiver definido como UTC. Felizmente, os valores de fuso horário de data do formulário podem ser modificados sem interromper as linhas existentes.

Selecionei somente data na coluna da minha tabela, mas meu formulário está mostrando um seletor de hora juntamente com a data

Isso aconteceria se você escolher um comportamento de independente de fuso horário ou local do usuário para sua coluna somente data. No Dataverse, ele armazenará um horário de 00:00:00 por padrão, mas se você adicionar a coluna a um formulário, ele assumirá que você também precisa definir o horário. Se você deixar os seletores de horário no formulário, os usuários poderão inserir um horário e ele será salvo como algo diferente de 00:00:00. Como você pode consertar isso?

• Edite o formulário e remova o selecionador de horário e as fórmulas associadas. Isso registrará o horário como 00:00:00 e ainda permitirá cálculos de data com base no fuso horário.
• Se sua coluna estiver atualmente definida para o local do usuário e não precisar que a data seja calculada para o fuso horário, você pode alterá-la para somente data. Esta é uma alteração permanente e não pode ser desfeita. Essa alteração não pode ser feita em colunas de comportamento independentes de fuso horário. Sempre tenha cuidado ao alterar comportamentos, pois outros aplicativos, plug-ins ou fluxos de trabalho podem confiar nos dados.

Eu tenho uma coluna somente data, mas está mostrando a data errada para alguns usuários

Se isso acontecer, verifique o comportamento configurado para a coluna somente data. Se a coluna for definida como independente de fuso horário ou local do usuário, o carimbo de data/hora incluído fará com que a data apareça de forma diferente para usuários diferentes. As configurações de exibição do formulário UTC ou Local determinarão se a data exibida é calculada usando as configurações de fuso horário do usuário ou se a exibe como o valor UTC. Alterar os valores do formulário para UTC em vez do local do usuário evitará cálculos de deslocamento de fuso horário e exibirá a data UTC da linha salva. Como alternativa, se você precisa que seja uma data estática que não muda e a coluna é atualmente local do usuário, você pode alterar o comportamento da coluna para Somente Data. Contudo, tenha cautela, já que essa ação não pode ser desfeita.

Meu (script/plug-in) deve interceptar a data enviada usando o Universal Client antes que a conversão local do usuário ocorra, mas está sendo tratada como dados locais do usuário

O cliente da Web e o cliente universal têm comportamentos ligeiramente diferentes quando se trata de quando os dados são traduzidos entre o UTC e o Local do Usuário. No cliente Web, as datas são inseridas no cliente, passadas para a API conforme fornecido e convertidas posteriormente na hora local do usuário. Isso permitiu que scripts/plug-ins recuperassem os dados e executassem uma ação antes que os dados fossem transmitidos para os serviços da plataforma e traduzidos para a hora local do usuário. No cliente universal, a conversão de uma data em valores locais do usuário ocorre antes que os dados sejam passados para a API. Por esse motivo, os dados fornecidos não serão uma data UTC, mas uma data local do usuário com base no usuário que recuperou ou postou. Para resolver isso, um usuário pode:

• Altere o formulário para fuso horário independente, que manterá o valor UTC. Isso funciona apenas se o usuário não precisar que o formulário seja exibido no horário local do usuário.
• Modifique o script para detectar o deslocamento de fuso horário usado, recalcule de volta para o UTC no script e execute uma ação.

Operadores de consulta de data e hora sem suporte para o comportamento Somente Data

Os operadores de consulta relacionados a data e hora a seguir são inválidos para o comportamento Somente Data. Um erro de exceção de operador inválido é lançado quando um destes operadores é usado na consulta.

• Anterior a X Minutos
• Anterior a X Horas
• Últimas X Horas
• Próximas X Horas

Consulte também

Criar e editar colunas
Definir colunas calculadas para automatizar cálculos manuais
Propriedades gerenciadas da coluna
Propriedades gerenciadas
Blog: Trabalhando com fusos horários no Dataverse

Observação

Você pode nos falar mais sobre suas preferências de idioma para documentação? Faça uma pesquisa rápida. (Observe que esta pesquisa está em inglês)

A pesquisa levará cerca de sete minutos. Nenhum dado pessoal é coletado (política de privacidade).