De functies DateValue, TimeValue en DateTimeValue

  • Artikel

Van toepassing op: Canvas-apps Bureaubladstromen Modelgestuurde apps Power Platform CLI

Hiermee kunt u een datum, tijd of beide in een tekenreeks converteren naar een datum/tijd-waarde.

Beschrijving

  • De functie DateValue converteert een datumtekenreeks (bijvoorbeeld "10/01/2014") naar een datum/tijd-waarde.

  • De functie TimeValue converteert een tijdtekenreeks (bijvoorbeeld "12:15 PM") naar een datum/tijd-waarde.

  • De functie DateTimeValue converteert een datum- en tijdtekenreeks (bijvoorbeeld "January 10, 2013 12:13 AM") naar een datum/tijd-waarde.

De functie DateValue negeert alle tijdinformatie in de datumreeks, en de functie TimeValue negeert alle datuminformatie in de tijdreeks.

Notitie

De functies DateValue, TimeValue en DateTimeValue gebruiken standaard de taal van de huidige gebruikersinstellingen. U kunt deze overschrijven om ervoor te zorgen dat tekenreeksen correct worden geïnterpreteerd. "10/1/1920" wordt bijvoorbeeld geïnterpreteerd als October 1st in "en" en als January 10th in "fr".

Datums moeten in een van de volgende indelingen staan:

  • MM/DD/JJJJ of MM-DD-JJJJ
  • DD/MM/JJJJ of DD-MM-JJJJ
  • JJJJ/MM/DD of JJJJ-MM-DD
  • MM/DD/JJ of MM-DD-JJ
  • DD/MM/JJ of DD-MM-JJ
  • DD mnd JJJJ
  • Maand DD, JJJJ

Zie Date als u wilt weten hoe u numerieke datum-, maand- en jaargedeelten converteert.
Zie Time als u wilt weten hoe u numerieke uur-, minuut- en seconde-gedeelten converteert.

Voor meer informatie leest u:

Syntaxis

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

  • String: vereist. Een tekenreeks die een datum, tijd of combinatie van datum en tijd bevat.
  • Language: optioneel. Een taaltekenreeks, zoals wordt geretourneerd in de eerste twee tekens met de functie Language. Indien niet opgegeven, wordt de taal van de huidige gebruikersinstellingen gebruikt.

DateValue( Untyped )
DateTimeValue( Untyped )
TimeValue( Untyped )

  • Untyped: vereist. Niet-getypeerd object dat voor een datum of tijd staat. Aanvaardbare waarden zijn afhankelijk van de niet-getypeerde provider. Voor JSON wordt verwacht dat het niet-getypeerde object een JSON-tekenreeks is die een datum en tijd in ISO 8601-notatie bevat. Datums of tijden in andere notaties resulteren in een fout. Overweeg om dergelijke waarden eerst te converteren naar tekst en dan naar een datum of tijd. Houd er rekening mee dat tijdzones en aan landinstellingen gerelateerde notaties belangrijke overwegingen zijn bij het communiceren met externe systemen.

Voorbeelden

DateValue

Als u 11/10/2014 typt in een besturingselement voor tekstinvoer met de naam Startdatum en vervolgens de eigenschap Text van een label instelt op deze formules:

  • Converteer een datum van een tekenreeks in de landinstelling van de gebruiker en toon het resultaat als een lange datum.

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

    Apparaat ingesteld op landinstelling nl toont het label als Zaterdag 11 oktober 2014.

    Notitie

    U kunt verschillende opties gebruiken met de vaste-tekstwaarde DateTimeFormat. Als u een lijst met opties wilt weergeven, typt u de parameter gevolgd door een punt (.) in de formulebalk of raadpleegt u deText-functiereferentie.

  • Converteer een datum van een tekenreeks in de Franse landinstelling en toon het resultaat als een lange datum. In dit voorbeeld worden de maanden en dag van de maand anders geïnterpreteerd dan in het Engels.

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

    Apparaat ingesteld op landinstelling nl toont het label als Maandag 10 november 2014.

Als u in plaats daarvan October 20, 2014 had getypt:

  • Converteer een datum van een tekenreeks in de landinstelling van de gebruiker en bereken het verschil tussen twee dagen, in dagen

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

    Apparaat ingesteld op landinstelling nl toont het label als 9, met vermelding van het aantal dagen tussen 11 oktober en 20 oktober. De functie DateDiff kan ook het verschil in maanden, kwartalen of jaar tonen.

DateTimeValue

U typt 10/11/2014 1:50:24.765 PM in een besturingselement voor tekstinvoer met de naam Start en stelt vervolgens de eigenschap Text van een label in op de volgende formule:

  • Converteer zowel een datum- als een tijdtekenreeks in de huidige landinstelling.

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

    Apparaat ingesteld op landinstelling nl toont het label als Zaterdag 11 oktober 2014 13:50:24.

    Notitie

    U kunt verschillende opties gebruiken met de vaste-tekstwaarde DateTimeFormat. Als u een lijst met opties wilt weergeven, typt u de parameter gevolgd door een punt (.) in de formulebalk of raadpleegt u deText-functiereferentie.

  • Converteer zowel een datum- als een tijdtekenreeks in de Franse landinstelling. Maand en dag van de maand worden verschillend geïnterpreteerd.

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

    Apparaat ingesteld op landinstelling nl toont het label als Maandag 10 november 2014 13:50:24.

  • Converteer zowel een datum- als een tijdtekenreeks in de landinstelling van de gebruiker en geef het resultaat met een fractie van een seconde weer.

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

    Apparaat ingesteld op landinstelling nl toont het label als Zaterdag 11 oktober 2014 13:50:24.765.

    Als u de tijd wilt afronden naar de dichtstbijzijnde 10e of 100e van een seconde, voert u in de formule uu:mm:ss.f of uu:mm:ss.ff in.

TimeValue

Noem een besturingselement voor tekstinvoer FinishedAt en stel de eigenschap Text van een label in op deze functie:

If( TimeValue( FinishedAt.Text ) < TimeValue( "5:00:00.000 PM" ),
    "You made it!",
    "Too late!"
)
  • Als u 4:59:59.999 PM typt in het besturingselement FinishedAt toont het label Gehaald!
  • Als u 5:00:00.000 PM typt in het besturingselement FinishedAt toont het label Te laat!