Fonctions Now, Today et IsToday dans PowerAppsNow, Today, and IsToday functions in PowerApps

Renvoie la date et l’heure actuelles, et vérifie si une valeur de date/heure correspond au jour présent.Returns the current date and time, and tests whether a date/time value is today.

DescriptionDescription

La fonction Now renvoie la date et l’heure actuelles sous la forme d’une valeur de date/heure.The Now function returns the current date and time as a date/time value.

La fonction Today renvoie la date actuelle sous la forme d’une valeur de date/heure.The Today function returns the current date as a date/time value. La partie heure correspond à minuit.The time portion is midnight. Today présente la même valeur tout au long d’une journée, de minuit ce jour là à minuit le lendemain.Today has the same value throughout a day, from midnight today to midnight tomorrow.

La fonction IsToday vérifie si une valeur de date/heure est comprise entre minuit ce jour là et minuit le lendemain.The IsToday function tests whether a date/time value is between midnight today and midnight tomorrow. Cette fonction retourne une valeur booléenne (true ou false).This function returns a Boolean (true or false) value.

Toutes ces fonctions utilisent l’heure locale de l’utilisateur actuel.All these functions work with the local time of the current user.

Pour plus d’informations, voir Utilisation des dates et heures.See working with dates and times for more information.

Fonctions volatilesVolatile Functions

Now et Today sont des fonctions volatiles.Now and Today are volatile functions. Chaque fois qu’une de ces fonctions est évaluée, elle retourne une valeur différente.Each time one of these functions is evaluated it returns a different value.

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.When used in a data flow formula, a volatile function will only return a different value if the formula in which it appears is reevaluated. Si rien d’autre ne change dans la formule, elle aura la même valeur pendant toute l’exécution de votre application.If nothing else changes in the formula then it will have the same value throughout the execution of your app.

Par exemple, un contrôle d’étiquette Label1.Text = Now() ne change pas pendant que votre application est active.For example, a label control with Label1.Text = Now() will not change while your app is active. Seule la fermeture de l’application suivie de sa réouverture aboutit à une nouvelle valeur.Only closing and reopening the app will result in a new value.

La fonction est réévaluée si elle fait partie d’une formule où quelque chose d’autre a changé.The function will be reevaluated if it is part of a formula in which something else has changed. Par exemple, si nous modifions notre exemple en y intégrant un contrôle de curseur avec Label1.Text = DateAdd( Now(); Slider1.Value; Minutes ) , l’heure actuelle est extraite chaque fois que la valeur du contrôle de curseur change et la propriété Text de l’étiquette est réévaluée.For example, if we change our example to involve a slider control with Label1.Text = DateAdd( Now(); Slider1.Value; Minutes ) then the current time is retrieved each time the Slider control's value changes and the label's text property is reevaluated.

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.When used in a behavior formula, volatile functions will be evaluated each time the behavior formula is evaluated. Un exemple est donné ci-dessous.See below for an example.

SyntaxeSyntax

Now()Now()

Today()Today()

IsToday( DateTime )IsToday( DateTime )

  • DateTime : requis.DateTime - Required. Valeur de date/heure à tester.The date/time value to test.

ExemplesExamples

Pour les exemples de cette section, l’heure actuelle est 03:59 le 12 février 2015, et la langue est en-us.For the examples in this section, the current time is 3:59 AM on February 12, 2015, and the language is en-us.

FormuleFormula DescriptionDescription RésultatResult
Text( Now(); "mm/dd/yyyy hh:mm:ss" )Text( Now(); "mm/dd/yyyy hh:mm:ss" ) Récupère la date et l’heure actuelles et les affiche sous forme de chaîne.Retrieves the current date and time, and displays it as a string. "02/12/2015 03:59:00""02/12/2015 03:59:00"
Text( Today(); "mm/dd/yyyy hh:mm:ss" )Text( Today(); "mm/dd/yyyy hh:mm:ss" ) Récupère la date actuelle, la partie heure restant définie sur minuit, et l’affiche sous forme de chaîne.Retrieves the current date only, leaving the time portion as midnight, and displays it as a string. "02/12/2015 00:00:00""02/12/2015 00:00:00"
IsToday( Now() )IsToday( Now() ) Vérifie si la date et l’heure actuelles sont comprises entre minuit ce jour là et minuit le lendemain.Tests whether the current date and time is between midnight today and midnight tomorrow. truetrue
IsToday( Today() )IsToday( Today() ) Vérifie si la date actuelle est comprise entre minuit ce jour là et minuit le lendemain.Tests whether the current date is between midnight today and midnight tomorrow. truetrue
Text( DateAdd( Now(); 12 ); "mm/dd/yyyy hh:mm:ss" )Text( DateAdd( Now(); 12 ); "mm/dd/yyyy hh:mm:ss" ) Récupère la date et l’heure actuelles, y ajoute 12 jours et affiche le résultat sous forme de chaîne.Retrieves the current date and time, adds 12 days to the result, and displays it as a string. "02/24/2015 03:59:00""02/24/2015 03:59:00"
Text( DateAdd( Today(); 12 ); "mm/dd/yyyy hh:mm:ss" )Text( DateAdd( Today(); 12 ); "mm/dd/yyyy hh:mm:ss" ) Récupère la date, y ajoute 12 jours et affiche le résultat sous forme de chaîne.Retrieves the current date, adds 12 days to the result, and displays it as a string. "02/24/2015 00:00:00""02/24/2015 00:00:00"
IsToday( DateAdd( Now(); 12 ) )IsToday( DateAdd( Now(); 12 ) ) Vérifie si la date et l’heure actuelles plus 12 jours sont comprises entre minuit ce jour là et minuit le lendemain.Tests whether the current date and time, plus 12 days, is between midnight today and midnight tomorrow. falsefalse
IsToday( DateAdd( Today(); 12 ) )IsToday( DateAdd( Today(); 12 ) ) Vérifie si la date actuelle plus 12 jours est comprise entre minuit ce jour là et minuit le lendemain.Tests whether the current date, plus 12 days, is between midnight today and midnight tomorrow. falsefalse

Affiche une horloge qui se met à jour en temps réelDisplay a clock that updates in real time

  1. Ajoutez un contrôle Timer , définissez sa propriété Duration sur 1000 et définissez sa propriété Repeat sur true.Add a Timer control, set its Duration property to 1000, and set its Repeat property to true.

    Le minuteur s’exécute pendant une seconde, redémarre automatiquement et continue sur ce schéma.The timer will run for one second, automatically start over, and continue that pattern.

  2. Définissez la propriété OnTimerEnd sur cette formule :Set the control's OnTimerEnd property to this formula:

    Set( CurrentTime; Now() )Set( CurrentTime; Now() )

    Chaque fois que le minuteur redémarre (après chaque seconde), cette formule définit la variable globale CurrentTime sur la valeur actuelle de la fonction Now.Whenever the timer starts over (after each second), this formula sets the CurrentTime global variable to the current value of the Now function.

    Écran contenant un contrôle de minuteur avec la formule OnTimerEnd = Set(CurrentTime, Now())

  3. Ajoutez un contrôle Label et définissez sa propriété Text sur cette formule :Add a Label control, and set its Text property to this formula:

    Text( CurrentTime; LongTime24 )Text( 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.Use the Text function to format the date and time however you want, or set this property to just CurrentTime to show hours and minutes but not seconds.

    Écran contenant un contrôle d’étiquette avec la propriété Text définie sur Text( CurrentTime, LongTime24)

  4. Affichez un aperçu de l’application en appuyant sur F5, puis cliquez ou appuyez sur le minuteur pour le démarrer.Preview the app by pressing F5, and then start the timer by clicking or tapping it.

    L’étiquette montre en permanence l’heure actuelle, arrondie à la seconde.The label continually shows the current time, down to the second.

    Quatre écrans affichant quatre valeurs d’heure (13:50:22, 13:50:45, 13:51:03 et 13:51:25)

  5. Définissez la propriété AutoStart du minuteur sur true et sa propriété Visible sur false.Set the timer's AutoStart property to true and its Visible property to false.

    Le minuteur est invisible et démarre automatiquement.The timer is invisible and starts automatically.

  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 the screen's OnStart property so that the CurrentTime variable has a valid value, as in this example:

    Set(CurrentTime; Now())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).The label appears as soon as the app starts (before the timer runs for a full second).