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.

Par défaut, la langue utilisée est celle de l’utilisateur actuel. Toutefois, vous pouvez remplacer cette option pour vous assurer que les chaînes sont correctement interprétées. 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/JJ/AAAA
  • JJ/MM/AAAA
  • JJ Mois AAAA
  • Mois JJ, AAAA

Consultez les fonctions Date et Time pour effectuer une conversion à partir de composants numériques de type date, mois et année, ainsi que heure, minute et seconde.

Pour plus d’informations, voir également Utilisation des dates et heures.

Pour convertir des nombres, voir la fonction Value.

Syntaxe

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

  • *String* : requis. 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 du client de l’utilisateur actuel qui est utilisée.

Exemples

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 cette fonction :

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

    L’étiquette affiche samedi 11 octobre 2014 si votre ordinateur est configuré en anglais.

    Remarque : vous pouvez utiliser plusieurs options, autres que LongDateTime, avec le paramètre DateTimeFormat. Pour afficher une liste de ces options, tapez le paramètre suivi immédiatement d’un point d’exclamation dans la zone de fonction.

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

    L’étiquette affiche lundi 10 novembre 2014.

Si vous avez effectué la même chose sur 20 octobre 2014 :

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

    Si votre ordinateur est configuré en anglais, l’étiquette affiche 9, soit le nombre de jours entre le 11 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 cette fonction :

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

    L’étiquette affiche samedi 11 octobre 2014 1:50:24 PM si votre ordinateur est configuré en anglais.

    Remarque : vous pouvez utiliser plusieurs options, autres que LongDateTime, avec le paramètre DateTimeFormat. Pour afficher une liste de ces options, tapez le paramètre suivi immédiatement d’un point d’exclamation dans la zone de fonction.

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

    L’étiquette affiche lundi 10 novembre 2014 1:50:24 PM.

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

    L’étiquette affiche samedi 11 octobre 2014 01:50:24:765 PM si votre ordinateur est configuré en anglais.

    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 fonction :

If(TimeValue(FinishedAt.Text)<TimeValue("5:00:00.000 PM"), "Bien joué !", "Trop tard !")

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