Fonctions DateAdd, DateDiff et TimeZoneOffset dans PowerAppsDateAdd, DateDiff, and TimeZoneOffset functions in PowerApps

Modifie une valeur de date/heure ou détermine la différence entre des valeurs de date/heure, et opère la conversion entre l’heure locale et l’heure UTC.Adds to or finds the difference in date/time values and converts between local time and UTC.

DescriptionDescription

La fonction DateAdd ajoute un nombre d’unités à une valeur de date/heure.The DateAdd function adds a number of units to a date/time value. Le résultat est une nouvelle valeur de date/heure.The result is a new date/time value. Vous pouvez également soustraire un nombre d’unités d’une valeur de date/heure en spécifiant une valeur négative.You can also subtract a number of units from a date/time value by specifying a negative value.

La fonction DateDiff retourne la différence entre deux valeurs de date/heure.The DateDiff function returns the difference between two date/time values. Le résultat est un nombre d’unités.The result is a number of units.

Pour les deux fonctions, les unités peuvent être Millisecondes, Secondes, Minutes, Heures, Jours, Mois, Trimestres ou Années.For both functions, units can be Milliseconds, Seconds, Minutes, Hours, Days, Months, Quarters, or Years. Par défaut, les deux fonctions utilisent les jours (Days) en tant qu’unités.By default, both functions use Days as units.

La fonction TimeZoneOffset retourne le nombre de minutes entre l’heure locale et l’heure UTC (temps universel coordonné) de l’utilisateur.The TimeZoneOffset function returns the number of minutes between the user's local time and UTC (Coordinated Universal Time).

Vous pouvez utiliser DateAdd avec TimeZoneOffset pour opérer une conversion entre l’heure locale et l’heure UTC (temps universel coordonné) de l’utilisateur.You can use DateAdd with the TimeZoneOffset to convert between the user's local time and UTC (Coordinated Universal Time). L’ajout de TimeZoneOffset convertit une heure locale en heure UTC, et sa soustraction (en ajoutant la valeur négative) convertit une heure UTC en heure locale.Adding TimeZoneOffset will convert a local time to UTC, and subtracting it (adding the negative) will convert from UTC to local time.

Pour plus d’informations, consultez également Utilisation des dates et heures.Also see working with dates and times for more information.

SyntaxeSyntax

DateAdd( DateTime, Addition [, Units ] )DateAdd( DateTime, Addition [, Units ] )

  • DateTime : requis.DateTime - Required. Valeur de date/heure à utiliser.Date/time value to operate on.
  • Addition - Requis.Addition - Required. Nombre, exprimé en Unités, à ajouter à la valeur DateTime.Number, in Units, to add to the DateTime.
  • Units - Facultatif.Units - Optional. Type d’Unités à ajouter : Millisecondes, Secondes, Minutes, Heures, Jours, Mois, Trimestres ou Années.The type of Units to add: Milliseconds, Seconds, Minutes, Hours, Days, Months, Quarters, or Years. Si les unités ne sont pas spécifiées, l’unité Days est utilisée.If not specified, Days are used.

DateDiff( StartDateTime, EndDateTime [, Units ] )DateDiff( StartDateTime, EndDateTime [, Units ] )

  • StartDateTime - Requis.StartDateTime - Required. Valeur de date/heure de début.Starting date/time value.
  • EndDateTime - Requis.EndDateTime - Required. Valeur de date/heure de fin.Ending date/time value.
  • Units - Facultatif.Units - Optional. Type d’Unités à ajouter : Millisecondes, Secondes, Minutes, Heures, Jours, Mois, Trimestres ou Années.The type of Units to add: Milliseconds, Seconds, Minutes, Hours, Days, Months, Quarters, or Years. Si les unités ne sont pas spécifiées, l’unité Days est utilisée.If not specified, Days are used.

TimeZoneOffset( [ DateTime ] )TimeZoneOffset( [ DateTime ] )

  • DateTime : facultatif.DateTime - Optional. Valeur de date/heure pour laquelle retourner le décalage.Date/time value for which to return the offset. Par défaut, la date/heure actuelle est utilisée.By default, the current date/time is used.

ExemplesExamples

Dans tous ces exemples, supposons que la date et l’heure sont 15 juillet 2013, 13:02.In all of these examples, assume that the current date and time is July 15, 2013, 1:02 PM.

DateAdd simpleSimple DateAdd

FormuleFormula DescriptionDescription RésultatResult
Text( DateAdd( Now(), 3 ),
"jj-mm-aaaa hh:mm" )
Text( DateAdd( Now(), 3 ),
"dd-mm-yyyy hh:mm" )
Ajoute trois jours (unités par défaut) à la valeur de date/heure actuelle.Adds three days (default units) to the current date and time. « 18-07-2013 13:02 »"18-07-2013 13:02"
Text( DateAdd( Now(), 4, Hours ),
"jj-mm-aaaa hh:mm" )
Text( DateAdd( Now(), 4, Hours ),
"dd-mm-yyyy hh:mm" )
Ajoute quatre heures à la valeur de date/heure actuelle.Add four hours to the current date and time. « 15-07-2013 17:02 »"15-07-2013 17:02"
Text( DateAdd( Today(), 1, Months ),
"jj-mm-aaaa hh:mm" )
Text( DateAdd( Today(), 1, Months ),
"dd-mm-yyyy hh:mm" )
Ajoute un mois à la date actuelle, sans l’heure, car Today ne renvoie pas de composant d’heure.Adds one month to the current date, without time as Today doesn't return a time component. « 15-08-2013 00:00 »"15-08-2013 00:00"
Text( DateAdd( Now(), ‑30, Minutes ),
"jj-mm-aaaa hh:mm" )
Text( DateAdd( Now(), ‑30, Minutes ),
"dd-mm-yyyy hh:mm" )
Soustrait 30 minutes de la valeur de date/heure actuelle.Subtracts 30 minutes from the current date and time. « 15-07-2013 12:32 »"15-07-2013 12:32"

DateDiff simpleSimple DateDiff

FormuleFormula DescriptionDescription RésultatResult
DateDiff( Now(), DateValue("1/1/2014") )DateDiff( Now(), DateValue("1/1/2014") ) Retourne la différence entre les deux unités, exprimée en unités par défaut de JoursReturns the difference between the two units in the default units of Days 170170
DateDiff( Now(), DateValue("1/1/2014"), Months )DateDiff( Now(), DateValue("1/1/2014"), Months ) Retourne la différence entre les deux valeurs de MoisReturns the difference between the two values in Months 66
DateDiff( Now(), Today(), Minutes )DateDiff( Now(), Today(), Minutes ) Retourne la différence entre la date/heure actuelle et la date actuelle (sans heure) en minutes.Returns the difference between the current date/time and the current date only (no time) in minutes. Étant donné que la valeur Now est postérieure à la valeur Today, le résultat est négatif.Since the Now is later than Today the result will be negative. -782-782

Conversion en heure UTCConverting to UTC

Pour convertir au format UTC (temps universel coordonné), ajoutez la valeur TimeZoneOffset pour l’heure indiquée.To convert to UTC (Coordinated Universal Time), add the TimeZoneOffset for the given time.

Par exemple, imaginez que la valeur de date/heure soit 15 juillet 2013, 13:02 en heure d’été du Pacifique (UTC-7).For example, imagine the current date and time is July 15, 2013, 1:02 PM in Pacific Daylight Time (PDT, UTC-7). Pour déterminer l’heure en heure UTC, utilisez la formule :To determine the current time in UTC, use:

  • DateAdd( Now(), TimeZoneOffset(), Minutes )DateAdd( Now(), TimeZoneOffset(), Minutes )

TimeZoneOffset indiquant par défaut l’heure actuelle, vous n’avez pas besoin de le passer en tant qu’argument.TimeZoneOffset defaults to the current time, so you don't need to pass it an argument.

Pour afficher le résultat, utilisez la fonction Texte avec le format jj-mm-aaaa hh:mm, qui retournera 15-07-2013 20:02.To see the result, use the Text function with the format dd-mm-yyyy hh:mm, which will return 15-07-2013 20:02.

Conversion de l’heure UTCConverting from UTC

Pour convertir l’heure UTC, soustrayez TimeZoneOffset (en ajoutant le signe négatif) de l’heure indiquée.To convert from UTC, subtract the TimeZoneOffset (by adding the negative) for the given time.

Par exemple, imaginez que la valeur de date/heure UTC 15 juillet 2013, 20:02 est stockée dans une variable nommée StartTime.For example, imagine the UTC date and time July 15, 2013, 8:02 PM is stored in a variable named StartTime. Pour régler l’heure en fonction du fuseau horaire de l’utilisateur, utilisez la formule :To adjust the time for the user's time zone, use:

  • DateAdd( StartTime, -TimeZoneOffset( StartTime ), Minutes )DateAdd( StartTime, -TimeZoneOffset( StartTime ), Minutes )

Notez le signe négatif devant TimeZoneOffset, qui indique de soustraire le décalage au lieu de l’ajouter.Note the negative sign before TimeZoneOffset to subtract the offset rather than add it.

Pour afficher le résultat, utilisez la fonction Text avec le format jj-mm-aaaa hh:mm, qui retourne 15-07-2013 13:02 si vous êtes dans le fuseau horaire Pacifique (heure d’été).To see the result, use the Text function with the format dd-mm-yyyy hh:mm, which will result in 15-07-2013 13:02 if you're in Pacific Daylight Time.