DateValue, TimeValueet DateTimeValue fonctions

S’applique à : Les applications Canvas Copilot Studio Desktop circulent des applications basées sur des modèles power Platform CLI Dataverse functions Power Pages

Permet de convertir une chaîne composée d’une date et/ou d’une heure en une valeur date/heure.

Description

• DateValue la fonction convertit une chaîne de date (par exemple, « 10/01/2014 ») en valeur de date/heure .

• TimeValue la fonction convertit une chaîne d’heure (par exemple, « 12:15 PM ») en valeur de date/heure .

• DateTimeValue la fonction convertit une chaîne de date et d’heure (par exemple, « 10 janvier 2013 12:13 AM ») en valeur date/heure .

DateValue la fonction ignore toutes les informations d’heure dans la chaîne de date, et TimeValue la fonction ignore toutes les informations de date dans la chaîne d’heure.

Les dates doivent utiliser l’un des formats suivants :

• MM/DD/YYYY ou MM-DD-YYYY
• DD/MM/YYYY ou DD-MM-YYYY
• YYYY/MM/DD ou YYYY-MM-DD
• MM/DD/YY ou MM-DD-YY
• DD/MM/YY ou DD-MM-YY
• JJ Mois AAAA
• Mois JJ, AAAA

Pour convertir des composants de date, de mois et d’année numériques, lisez Date.
Pour convertir des composants numériques d’heure, de minute et de seconde, lisez Time.

Pour plus d’informations, consultez :

• Utilisation de la date et de l’heure
• Types de date/heure et de données

Syntaxe

DateValue( String [, Language] )
DateTimeValue( String [, Language ] )
TimeValue( String [, Language ] )

• Chaîne - Obligatoire. Chaîne de texte contenant une valeur date et/ou heure.
• Langue - Facultatif. Chaîne de langue, par exemple celle renvoyée par les deux premiers caractères de la fonction Language. Si aucune langue n’est fournie, c’est celle des paramètres de l’utilisateur actuel qui est utilisée.

DateValue( Dynamique )
DateTimeValue( Dynamique )
TimeValue( Dynamique )

• Dynamique : obligatoire. Valeur dynamique qui représente une date ou une heure. Les valeurs acceptables dépendent du fournisseur sans type. Pour JSON, la valeur dynamique est censée être une chaîne JSON qui contient une date et une heure au format ISO 8601. Les dates ou les heures dans d’autres formats entraînent une erreur. Pensez à convertir ces valeurs en texte tout d’abord, puis en date ou heure. Gardez à l’esprit que les fuseaux horaires et les formats liés aux paramètres régionaux sont des considérations importantes lors de la communication avec des systèmes externes.

Examples

DateValue

Si vous avez tapé 10/11/2014 dans un contrôle d’entrée de texte nommé Startdate, puis que vous avez défini la propriété Text d’une étiquette sur ces formules :

• Convertissez une date à partir d’une chaîne dans les paramètres régionaux de l’utilisateur et affichez le résultat sous forme de date longue.

  Text( DateValue( Startdate.Text ), DateTimeFormat.LongDate )
  

  Périphérique défini sur les paramètres régionaux en affichent l’étiquette comme Saturday, October 11, 2014.

  Note

  Vous pouvez utiliser plusieurs options avec l’enum DateTimeFormat. Pour afficher une liste d’options, tapez le paramètre suivi d’un point ou d’un point (.) dans la barre de formule ou cochez la référence de fonction Text.

• Convertissez une date à partir d’une chaîne dans les paramètres régionaux français et affichez le résultat sous forme de date longue. Dans cet exemple, les mois et le jour du mois sont interprétés différemment de l’anglais.

  Text( DateValue( Startdate.Text, "fr" ), DateTimeFormat.LongDate )
  

  Périphérique défini sur les paramètres régionaux en affichent l’étiquette comme Lundi, 10 novembre 2014.

Si vous entrez le 20 octobre 2014 à la place :

• Convertir une date à partir d’une chaîne dans les paramètres régionaux de l’utilisateur et calculer la différence entre deux jours, en jours

  DateDiff( DateValue( Startdate.Text ), Today() )
  

  Périphérique défini sur les paramètres régionaux en affichent l’étiquette comme 9, indiquant le nombre de jours entre le 11 octobre et le 20 octobre. La fonction DateDiff peut également afficher la différence en mois, trimestres ou années.

DateTimeValue

Si vous avez tapé 10/11/2014 13:50:24.765 dans un contrôle d’entrée de texte nommé Start, puis que vous avez défini la propriété Text d’une étiquette sur la formule suivante :

• Convertissez une chaîne de date et d’heure dans les paramètres régionaux actuels.

  Text( DateTimeValue( Start.Text ), DateTimeFormat.LongDateTime )
  

  Périphérique défini sur les paramètres régionaux en affichent l’étiquette comme Samedi 11 octobre 2014 13:50:24.

  Note

  Vous pouvez utiliser plusieurs options avec l’enum DateTimeFormat. Pour afficher une liste d’options, tapez le paramètre suivi d’un point ou d’un point (.) dans la barre de formule ou cochez la référence de fonction Text.

• Convertissez une chaîne de date et d’heure dans les paramètres régionaux français. Le mois et le jour du mois sont interprétés différemment.

  Text( DateTimeValue( Start.Text, "fr"), DateTimeFormat.LongDateTime )
  

  Périphérique défini sur les paramètres régionaux en affichent l’étiquette comme Lundi, 10 novembre 2014 1:50:24 PM.

• Convertissez une chaîne de date et d’heure dans les paramètres régionaux de l’utilisateur et affichez le résultat avec une fraction de seconde.

  Text( DateTimeValue( Start.Text ), "dddd, mmmm dd, yyyy hh:mm:ss.fff AM/PM" )
  

  Périphérique défini sur les paramètres régionaux en affichent l’étiquette comme Samedi 11 octobre 2014 01:50:24.765 PM.

  Pour arrondir l’heure au dixième ou au centième de seconde près, vous pouvez également indiquer ^hh:mm:ss.f ou ^hh:mm:ss.ff dans la formule.

TimeValue

Nommez un contrôle d’entrée de texte FinishedAt puis définissez la propriété Text d’une étiquette sur cette formule :

If( TimeValue( FinishedAt.Text ) < TimeValue( "5:00:00.000 PM" ),
    "You made it!",
    "Too late!"
)

• Si vous tapez 4:59:59.999 PM dans le contrôle FinishedAt, l’étiquette affiche « Bien joué ! ».
• Si vous tapez 5:00:00.000 PM dans le contrôle FinishedAt, l’étiquette affiche « Trop tard ! ».