Del via

Funksjonene DateValue, TimeValue og DateTimeValue

  • Artikkel

Gjelder: Lerretsapper Skrivebordsflyt Modelldrevne apper Power Platform CLI

Konverterer en dato, et klokkeslett eller begge deler i en string til en dato/klokkeslett-verdi.

Beskrivelse

  • DateValue-funksjonen konverterer en datostreng (for eksempel "10/01/2014") til en dato/klokkeslett-verdi.

  • TimeValue-funksjonen konverterer en tidsstreng (for eksempel "12:15 PM") til en dato/klokkeslett-verdi.

  • DateTimeValue-funksjonen konverterer en dato- og tidsstreng (for eksempel "January 10, 2013 12:13 AM") til en dato/klokkeslett-verdi.

DateValue-funksjonen ignorerer all informasjon om klokkeslett i datostrengen, og TimeValue-funksjonen ignorerer all datoinformasjon i klokkeslettstrengen.

Obs!

Funksjonene DateValue, TimeValue og DateTimeValue bruker som standard språket fra innstillingene for gjeldende bruker. Du kan overstyre det for å sikre at strengene tolkes på riktig måte. For eksempel tolkes "10/1/1920" som 1. oktober i "en" (engelsk) og som 10.januar i "fr" (fransk).

Datoer må være i ett av disse formatene:

  • 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 ÅÅÅÅ
  • Måned DD, ÅÅÅÅ

Hvis du vil konvertere fra dato-, måneds-og årskomponenter, leser du Date.
Hvis du vil konvertere fra numeriske time-, minutt- og sekundkomponenter, leser du Time.

Hvis du vil ha mer informasjon, kan du se:

Syntaks

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

  • String – obligatorisk. En tekststreng som inneholder en dato, et klokkeslett eller en kombinasjon av dato og klokkeslett.
  • Language - valgfritt. En språklinje, av den typen som returneres av de to første tegnene i Language-funksjonen. Hvis språk ikke er angitt, brukes språkinnstillingene til gjeldende bruker.

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

  • Untyped - v. Untyped object som representere dato og klokkeslett. Godkjente verdier er avhengig av leverandøren uten type. For JSON forventes det at objektet uten type er en JSON-streng som inneholder en dato og et klokkeslett i ISO 8601-format. Datoer eller klokkeslett i andre formater fører til en feil. Vurder å konvertere slike verdier til Tekst først, og deretter til dato og klokkeslett. Husk at tidssoner og formater for nasjonale innstillinger er viktige vurderinger ved kommunikasjon med eksterne systemer.

Eksempler

DateValue

Hvis du for eksempel skriver inn 10/11/2014 i en kontroll for text-input med navnet Startdato, og deretter angir Text-egenskapen for en etikett til disse formlene:

  • Konverter en dato fra en streng i brukerens nasjonale innstillinger, og vis resultatet som en lang dato.

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

    Enhet satt til en nasjonal innstilling, viser etiketten som Lørdag, 11. oktober 2014.

    Obs!

    Du kan bruke flere alternativer med DateTimeFormat-opplistingen. Hvis du vil vise en liste over alternativer, skriver du inn parameteren etterfulgt av en prikk eller et punktum (.) på formellinjen eller sjekker referansen til Text-funksjonen.

  • Konverter en dato fra en streng i nasjonale innstillinger for Frankrike, og vis resultatet som en lang dato. I dette eksemplet tolkes månedene og dagen i måneden på en annen måte enn engelsk.

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

    Enhet satt til en nasjonal innstilling, viser etiketten som Mandag, 10. november 2014.

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

  • Konvertere en dato fra en streng i brukerens nasjonale innstilling og beregne forskjellen mellom to dager, i dager

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

    Enhet satt til en som nasjonal innstilling, viser etiketten som 9, noe som angir antallet dager mellom 11. oktober og 20. oktober. DateDiff-funksjonen kan også vise differansen i måneder, kvartaler eller år.

DateTimeValue

Hvis du har skrevet inn 10/11/2014 1:50:24.765 PM i en kontroll for text-input med navnet Start, og deretter angitt Text-egenskapen til en etikett til følgende formel:

  • Konverter både dato- og klokkeslettstreng i gjeldende nasjonal innstilling.

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

    Enhet satt til en nasjonal innstilling, viser etiketten som Lørdag, 11. oktober 2014 1:50:24 PM.

    Obs!

    Du kan bruke flere alternativer med DateTimeFormat-opplistingen. Hvis du vil vise en liste over alternativer, skriver du inn parameteren etterfulgt av en prikk eller et punktum (.) på formellinjen eller sjekker referansen til Text-funksjonen.

  • Konverter både dato- og klokkeslettstreng i nasjonal innstilling for Frankrike. Måneden og dagen i måneden tolkes på en annen måte.

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

    Enhet satt til en nasjonal innstilling, viser etiketten som Mandag, 10. november 2014 1:50:24 PM.

  • Konverter både en dato- og klokkeslettstreng i brukerens nasjonale innstilling, og vis resultatet med en desimaldel av sekund.

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

    Enhet satt til en nasjonal innstilling, viser etiketten som Lørdag, 11. oktober 2014 01:50:24.765 PM.

    Alternativt kan du angi hh:mm:ss.f eller hh:mm:ss.ff for å runde av tiden til nærmeste 10-dels eller 100-dels sekund.

TimeValue

Navngi en kontroll for text-input som FinishedAt, og angi Text-egenskapen for en etikett til denne formelen:

If( TimeValue( FinishedAt.Text ) < TimeValue( "5:00:00.000 PM" ),
    "You made it!",
    "Too late!"
)
  • Hvis du skriver inn 4:59:59.999 PM i FinishedAt-kontrollen, viser etiketten "You made it!"
  • Hvis du skriver inn 5:00:00.000 PM i FinishedAt-kontrollen, viser etiketten "Too late!"