Funções Now, Today, IsToday, UTCNow, UTCToday, IsUTCToday

Aplica-se a: Aplicativos de tela Fluxos de área de trabalho Colunas de fórmula do Dataverse Aplicativos baseados em modelo Power Platform CLI

Retorna a data e hora atuais e testa se um valor de data/hora é hoje.

Description

A função Now retorna a data atual e a hora como um valor de data/hora.

A função Today retorna a data atual como um valor de data/hora. A parte da hora é meia-noite. Today tem o mesmo valor ao longo do dia, da meia-noite de hoje até a meia-noite de amanhã.

A função IsToday testa se um valor de data/hora está entre meia-noite de hoje e meia-noite de amanhã. Essa função retorna um valor booliano (true ou false).

As funções Now, Today e IsToday funcionam com o horário local do usuário atual.

As funções UTCNow, UTCToday e IsUTCToday são iguais às suas equivalentes não UTC, mas funcionam com valores independentes de fuso horário e usam o Tempo Universal Coordenado (UTC).

Consulte Data, hora e DateTime na documentação de tipos de dados e como trabalhar com datas e horários para obter mais informações.

Funções voláteis

Now, Today, UTCNow e UTCToday são funções voláteis. Essas funções retornam um valor diferente para cada avaliação.

Quando usada em uma fórmula de fluxo de dados, uma função volátil retornará um valor diferente apenas se a fórmula em que ela aparece for reavaliada. Se nada mais mudar na fórmula, ela terá o mesmo valor durante a execução do aplicativo.

Por exemplo, um controle de rótulo com Label1.Text = Now() não será alterado enquanto o aplicativo estiver ativo. Somente fechar e abrir o aplicativo novamente resultará em um novo valor.

A função será reavaliada se fizer parte de uma fórmula em que algo tenha sido alterado. Por exemplo, se o exemplo for alterado para envolver um controle deslizante com Label1.Text = DateAdd( Now(), Slider1.Value, Minutes ), o horário atual será recuperado toda vez que o valor do controle Slider for alterado e a propriedade de texto do rótulo for reavaliada.

Quando usadas em uma fórmula de comportamento, as funções voláteis serão avaliadas toda vez que a fórmula de comportamento for avaliada. Veja um exemplo abaixo.

Sintaxe

Usar o horário local do usuário

Now()

Today()

IsToday( DateTime )

• DateTime - obrigatório. O valor de data/hora a ser testado.

Usar o Tempo Universal Coordenado (UTC)

UTCNow()

UTCToday()

IsUTCToday(TimeZoneIndependentTime)

• TimeZoneIndependentDateTime - obrigatório. O valor de data/hora independente do fuso horário a ser testado.

Exemplos

Para os exemplos desta seção, o horário atual é 20h58 em 11 de julho de 2021 no fuso horário do Pacífico (UTC-8), e o idioma é pt-br.

Exibe um relógio que atualiza em tempo real

1. Adicione um controle Timer, defina a propriedade Duration como 1000 e a propriedade Repeat como true.

   O cronômetro será executado por um segundo, reiniciará automaticamente e continuará esse padrão.

2. Defina a propriedade OnTimerEnd do controle com esta fórmula:

   Set( CurrentTime, Now() )

   Sempre que o cronômetro for reiniciado (após cada segundo), essa fórmula definirá a variável global CurrentTime como o valor atual da função Now.

   

3. Adicione um controle Label e defina sua propriedade Text com esta fórmula:

   Text( CurrentTime, LongTime24 )

   Use a função Text para formatar a data e hora conforme desejar, ou defina essa propriedade como CurrentTime para mostrar as horas e os minutos, mas não os segundos.

   

4. Visualize o aplicativo pressionando a tecla F5 e, em seguida, inicie o cronômetro clicando ou tocando nele.

   De forma contínua, o rótulo mostrará a hora atual, até os segundos.

   

5. Defina a propriedade AutoStart do cronômetro como true e a propriedade Visible como false.

   O cronômetro é invisível e inicia automaticamente.

6. Defina a propriedade OnStart da tela para que a variável CurrentTime tenha um valor válido, como neste exemplo:

   Set(CurrentTime, Now())

   O rótulo será exibido assim que o aplicativo iniciar (antes de o cronômetro ser executado por um segundo inteiro).