DateValue, TimeValueen DateTimeValue functies

Van toepassing op: Canvas-apps Copilot Studio Desktop stromen Modelgestuurde apps Power Platform CLI Dataverse-functies Power Pages

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

Beschrijving

• DateValue met de functie wordt een datumtekenreeks (zoals 10/01/2014) geconverteerd naar een datum/tijd-waarde .

• TimeValue met de functie wordt een tijdtekenreeks (zoals '12:15 PM') geconverteerd naar een datum/tijd-waarde .

• DateTimeValue met de functie converteert u een datum- en tijdtekenreeks (zoals '10 januari 2013 12:13 am') naar een datum/tijd-waarde .

DateValue functie negeert tijdgegevens in de datumtekenreeks en TimeValue de functie negeert alle datumgegevens in de tijdtekenreeks.

Datums moeten een van deze notaties gebruiken:

• 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, zie:

• Werken met datum en tijd
• Datum/tijd en gegevenstypen

Syntaxis

DateValue( Tekenreeks [, Taal] )
DateTimeValue( Tekenreeks [, Taal ] )
TimeValue( Tekenreeks [, Taal ] )

• String - Verplicht. Een tekenreeks die een datum, tijd of combinatie van datum en tijd bevat.
• Taal - 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( Dynamisch )
DateTimeValue( Dynamisch )
TimeValue( Dynamisch )

• Dynamisch - vereist. Dynamische waarde die een datum of tijd vertegenwoordigt. Aanvaardbare waarden zijn afhankelijk van de niet-getypeerde provider. Voor JSON wordt verwacht dat de dynamische waarde een JSON-tekenreeks is die een datum- en tijdnotatie van ISO 8601 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 20 oktober 2014 invoert:

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