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

Functions	Aplica-se a
Now	Aplicativos de tela O Copilot Studio Desktop flui colunas de fórmula do Dataverse para aplicativos controlados por modelos do Power Platform CLI Dataverse functions Power Pages
Today IsToday	Aplicativos de tela Copilot Studio Desktop flui aplicativos baseados em modelo CLI CLI Dataverse funções Power Pages
UTCNow UTCToday	Colunas de fórmula do Dataverse Power Pages

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

Description

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

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

A IsToday função 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).

Now, Todaye IsToday as funções funcionam com a hora local do usuário atual.

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

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, Todaye UTCNowUTCToday 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 seu 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 alterarmos nosso exemplo para envolver um controle deslizante com Label1.Text = DateAdd( Now(), Slider1.Value, Minutes), a hora atual será recuperada sempre que o valor do controle deslizante 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 temporizador é iniciado (após cada segundo), essa fórmula define a variável global CurrentTime como o valor atual da Now função.

   

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

   Texto(HoraAtual,HoraLonga24)

   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).