Now, Today, , UTCNowIsToday, , UTCToday, IsUTCToday fonctions

Functions	S’applique à
Now	Les applications Canvas Copilot Studio Desktop circulent des colonnes de formule Dataverse basées sur des modèles d’applications Power Platform CLI Dataverse functions Power Pages
Today IsToday	Les applications Canvas Copilot Studio Desktop circulent des applications basées sur des modèles power Platform CLI Dataverse functions Power Pages
UTCNow UTCToday	Colonnes de formule Dataverse Power Pages

Renvoie la date et l’heure actuelles, et vérifie si une valeur de date/heure correspond au jour présent.

Description

La Now fonction retourne la date et l’heure actuelles sous forme de valeur date/heure.

La Today fonction retourne la date actuelle sous forme de valeur date/heure. La partie heure correspond à minuit. Today a la même valeur tout au long d’une journée, de minuit aujourd’hui à minuit demain.

La IsToday fonction teste si une valeur de date/heure est comprise entre minuit aujourd’hui et minuit demain. Cette fonction retourne une valeur booléenne (true ou false).

Now, Todayet IsToday les fonctions fonctionnent avec l’heure locale de l’utilisateur actuel.

UTCNow, UTCTodayet IsUTCToday les fonctions sont identiques à leurs équivalents non UTC, mais fonctionnent avec des valeurs indépendantes du fuseau horaire et utilisent le temps universel coordonné (UTC).

Consultez Date, Heure et DateHeure dans la documentation des types de données et Utilisation des dates et des heures pour plus d’informations.

Fonctions volatiles

Now, , TodayUTCNowet UTCToday sont des fonctions volatiles. Ces fonctions renvoient une valeur différente pour chaque évaluation.

Quand elle est utilisée dans une formule de flux de données, une fonction volatile retourne une valeur différente seulement si la formule dans laquelle elle apparaît est réévaluée. Si rien d’autre ne change dans la formule, elle aura la même valeur pendant toute l’exécution de votre application.

Par exemple, un contrôle d’étiquette avec Label1.Text = Now() ne change pas pendant que votre application est active. Seule la fermeture de l’application suivie de sa réouverture aboutit à une nouvelle valeur.

La fonction est réévaluée si elle fait partie d’une formule où quelque chose d’autre a changé. Par exemple, si nous modifions notre exemple pour impliquer un contrôle slider avec Label1.Text = DateAdd( Now(), Slider1.Value, Minutes ), l’heure actuelle est récupérée chaque fois que la valeur du contrôle Slider change et que la propriété de texte de l’étiquette est réévaluée.

Quand elles sont utilisées dans une formule de comportement, les fonctions volatiles sont évaluées chaque fois que la formule de comportement est évaluée. Un exemple est donné ci-dessous.

Syntaxe

Utilisation du fuseau horaire local de l’utilisateur

Now()

Today()

IsToday( DateTime )

• DateTime - Obligatoire. Valeur de date/heure à tester.

Utilisation du Temps universel coordonné (UTC)

UTCNow()

UTCToday()

IsUTCToday( TimeZoneIndependentTime )

• TimeZoneIndependentDateTime - Obligatoire. La valeur date/heure indépendante du fuseau horaire à tester.

Examples

Pour les exemples de cette section, l’heure actuelle est 20h58 au 11 juillet 2021 dans le fuseau horaire du Pacifique (UTC-8) et la langue est en-us.

Affiche une horloge qui se met à jour en temps réel

1. Ajoutez un contrôle Timer, définissez sa propriété Duration sur 1000 et définissez sa propriété Repeat sur true.

   Le minuteur s’exécute pendant une seconde, redémarre automatiquement et continue sur ce schéma.

2. Définissez la propriété OnTimerEnd sur cette formule :

   Set( CurrentTime, Now()

   Chaque fois que le minuteur démarre (après chaque seconde), cette formule définit la variable globale CurrentTime sur la valeur actuelle de la Now fonction.

   

3. Ajoutez un contrôle Label et définissez sa propriété Text sur cette formule :

   Texte( CurrentTime, LongTime24 )

   Utilisez la fonction Text pour mettre en forme la date et l’heure comme vous le souhaitez, ou définissez simplement cette propriété sur CurrentTime pour afficher les heures et les minutes, mais pas les secondes.

   

4. Affichez un aperçu de l’application en appuyant sur F5, puis cliquez ou appuyez sur le minuteur pour le démarrer.

   L’étiquette montre en permanence l’heure actuelle, arrondie à la seconde.

   

5. Définissez la propriété AutoStart du minuteur sur true et sa propriété Visible sur false.

   Le minuteur est invisible et démarre automatiquement.

6. Définissez la propriété OnStart de l’écran de façon à ce que la variable CurrentTime ait une valeur valide, comme dans cet exemple :

   Set(CurrentTime, Now())

   L’étiquette apparaît dès que l’application démarre (avant que le minuteur s’exécute pour une seconde complète).