Fonctions DateValue, TimeValue et DateTimeValue

  • Article

S’applique à : Applications canevas Flux de bureau Applications pilotées par modèle CLI Power Platform

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

Description

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

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

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

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

Note

Les fonctions DateValue, TimeValue et DateTimeValue utilisent par défaut la langue des paramètres de l’utilisateur actuel. Vous pouvez le remplacer pour vous assurer que les chaînes sont interprétées correctement. Par exemple, « 10/1/1920 » est interprété comme le 1er octobre en anglais et comme le 10  janvier en français.

Les dates doivent avoir 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, lisez :

Syntaxe

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

  • String : obligatoire. Chaîne de texte contenant une valeur date et/ou heure.
  • Language : 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( Sans type )
DateTimeValue( Sans type )
TimeValue( Sans type )

  • Sans type : obligatoire. Objet sans type qui représente une date ou une heure. Les valeurs acceptables dépendent du fournisseur sans type. Pour JSON, l’objet sans type doit être une chaîne JSON contenant une date et une heure au format ISO 8601. Les dates ou les heures dans d’autres formats entraîneront 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 avez tapé 20 octobre 2014 au lieu :

  • 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 ! ».