Funktionerne DateValue, TimeValue og DateTimeValue

  • Artikel

Gælder for: Lærredsapps Skrivebordsflows Modeldrevne apps Power Platform CLI

Konverterer en dato, et klokkeslæt eller begge dele i en streng til en dato/klokkeslæt-værdi.

Beskrivelse

  • Funktionen DateValue konverterer en datostreng (f.eks. "10/01/2014") til en dato/klokkeslæt-værdi.

  • Funktionen TimeValue konverterer en klokkeslætsstreng (f.eks. "12:15") til en dato/klokkeslæt-værdi.

  • Funktionen DateTimeValue konverterer en dato/klokkeslætsstreng (f.eks. 10. januar, 2013 00:13") til en dato/klokkeslæt-værdi.

Funktionen DateValue ignorerer alle oplysninger i datostrengen, og funktionen TimeValue ignorerer eventuelle datooplysninger i klokkeslætsstrengen.

Bemærk

Funktionerne DateValue, TimeValue og DateTimeValue bruger som standardsproget fra den aktuelle brugers indstillinger. Du kan tilsidesætte den for at sikre, at strengene fortolkes korrekt. "10/1/1920" fortolkes f.eks. som 1. oktober på "en" og som 10. januar på "fr".

Datoer skal være i et af disse formater:

  • MM/DD/ÅÅÅÅ eller MM-DD-ÅÅÅÅ
  • DD/MM/ÅÅÅÅ eller DD-MM-ÅÅÅÅ
  • ÅÅÅÅ/MM/DD eller ÅÅÅÅ-MM-DD
  • MM/DD/ÅÅ eller MM-DD-ÅÅ
  • DD/MM/ÅÅ eller DD-MM-ÅÅ
  • DD måned YYYY
  • Måned DD, ÅÅÅÅ

Hvis du vil konvertere fra numeriske dato-, måned- og årskomponenter, skal du læse Date.
Hvis du vil konvertere fra numeriske time-, minut- og sekundkomponenter, skal du læse Time.

Du få flere oplysninger ved at læse:

Syntaks

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

  • Streng - påkrævet. En tekststreng, der indeholder en dato, et klokkeslæt eller en kombination af dato/klokkeslætsværdien.
  • Language – valgfri. En sprogstreng ville blive returneret af de to første tegn fra funktionen Language. Hvis sproget ikke er angivet, bruges sproget for den aktuelle brugers indstilling.

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

  • Untyped - påkrævet. Objekt uden type, der repræsenterer en dato eller et klokkeslæt. Acceptable værdier afhænger af udbyderen af objektet uden type. For JSON forventes objektet uden type at være en JSON-streng, der indeholder en dato og et klokkeslæt i ISO 8601-format. Datoer eller klokkeslæt i andre formater resulterer i en fejl. Overvej først at konvertere sådanne værdier til Text og derefter til en dato eller et klokkeslæt. Husk på, at tidszoner og landestandardrelaterede formater er vigtige overvejelser, når du kommunikerer med eksterne systemer.

Eksempler

DateValue

Hvis du indtaster 10/11/2014 i et kontrolelement til tekstinput med navnet Startdate og derefter indstiller egenskaben Text for en etiket til disse formler:

  • Konvertér en dato fra en streng i brugerens landestandard og få vist resultatet som en lang dato.

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

    Hvis enheden er indstillet til landestandarden en, vises etiketten som lørdag, 11. oktober 2014.

    Bemærk

    Du kan bruge flere indstillinger sammen med DateTimeFormat--optællingen. Hvis du vil have vist en liste over indstillinger, skal du skrive parameteren efterfulgt af et punktum ( .) i formularlinjen eller se Text-funktionsreferencen.

  • Konvertér en dato fra en streng i den franske landestandard og få vist resultatet som en lang dato. I dette eksempel fortolkes månederne og dagen i måneden anderledes end på engelsk.

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

    Hvis enheden er indstillet til landestandarden en, vises etiketten som mandag, 10. november 2014.

Hvis du har skrevet 20. oktober 2014 i stedet for:

  • Konvertere en dato fra en streng i brugerens landestandard og beregne forskellen mellem to dage, i dage

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

    Hvis enheden er indstillet til landestandarden en, vises etiketten som 9 med en angivelse af antallet af dage mellem 11. og 20. oktober. Funktionen DateDiff kan også vise forskellen i måneder, kvartaler eller år.

DateTimeValue

Hvis du indtaster 10/11/2014 1:50:24.765 PM i et kontrolelement til tekstinput med navnet Start og derefter angiver egenskaben Text for en etiket til følgende formel:

  • Konvertere både en streng af typen dato og klokkeslæt i den aktuelle landestandard.

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

    Hvis enheden er indstillet til landestandarden en, vises etiketten som lørdag, 11. oktober 2014 13:50:24.

    Bemærk

    Du kan bruge flere indstillinger sammen med DateTimeFormat--optællingen. Hvis du vil have vist en liste over indstillinger, skal du skrive parameteren efterfulgt af et punktum ( .) i formularlinjen eller se Text-funktionsreferencen.

  • Konvertere både en streng af typen dato og klokkeslæt i den franske landestandard. Måned og dag i måneden fortolkes anderledes.

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

    Hvis enheden er indstillet til landestandarden en, vises etiketten som mandag, 10. november 2014 13:50:24.

  • Konvertere både en dato-og klokkeslæts streng i brugerens landestandard og få vist resultatet med en brøkdel sekund.

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

    Hvis enheden er indstillet til landestandarden en, vises etiketten som lørdag, 11. oktober 2014 13:50:24,765.

    Som et alternativ kan du angive hh:mm:ss.f eller hh:mm:ss.ff for at afrunde tid til den nærmeste tiendedel eller en hundrededel af et sekund.

TimeValue

Navngiv et FinishedAt-tekstinputkontrolelement, og angiv egenskaben Text for en etiket til denne formel:

If( TimeValue( FinishedAt.Text ) < TimeValue( "5:00:00.000 PM" ),
    "You made it!",
    "Too late!"
)
  • Hvis du skriver 4:59:59.999 PM i kontrolelementet FinishedAt, viser etiketten "Du klarede det!"
  • Hvis du skriver 5:00:00.000 PM i kontrolelementet FinishedAt, viser etiketten ""For sent!"