Share via

Funkcije DateValue, TimeValue in DateTimeValue

  • Članek

Velja za: Aplikacije delovnega območja Tokovi namizja Aplikacije Power Platform , ki temeljijo na modelu CLI

Pretvori datum, čas ali oboje v nizu na vrednost datuma/časa.

Opis

  • Funkcija DateValue pretvori datumski niz (na primer »10/01/2014«) v vrednost datuma/časa.

  • Funkcija TimeValue pretvori časovni niz (na primer »12:15«) v vrednost datuma/časa.

  • Funkcija DateTimeValue pretvori datumski in časovni niz (na primer »10. januar 2013, 12:13«) v vrednost datuma/časa.

Funkcija DateValue zanemari vse časovne informacije v datumskem nizu in funkcija TimeValue prezre vse datumske informacije v časovnem nizu.

opomba,

Funkcije »DateValue«, »TimeValue« in »DateTimeValue« privzeto uporabljajo jezik iz nastavitev trenutnega uporabnika. To lahko preglasite, da zagotovite, da so nizi interpretirani pravilno. Na primer »10/1/1920« je interpretirano kot October 1st v »en«in kot 10. januar v »sl«.

Datumi morajo biti v eni od teh oblik zapisa:

  • MM/DD/LLLL ali MM-DD-LLLL
  • DD/MM/LLLL ali DD-MM-LLLL
  • LLLL/MM/DD ali LLLL-MM-DD
  • MM/DD/LL ali MM-DD-LL
  • DD/MM/LL ali DD-MM-LL
  • DD Mesec LLLL
  • Mesec DD, LLLL

Za pretvorbo iz številčnih komponent datuma, meseca in leta preberite datum (Date).
Za pretvorbo iz številčnih komponent ure, minute in sekunde preberite čas (Time).

Več informacij najdete tukaj:

Sintaksa

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

  • String – obvezno. Besedilni niz, ki vsebuje datum, čas ali kombinacijo vrednosti datuma in časa.
  • Language – izbirno. Niz jezika, kot bi bil vrnjen s prvima dvema znakoma v funkciji Language. Če ni zagotovljen, se uporabijo nastavitve trenutnega uporabnika.

DateValue( Ni vrste )
DateTimeValue( Ni vrste )
TimeValue( Ni vrste )

  • Untyped – obvezno. Predmet brez vrste, ki predstavlja datum ali čas. Sprejemljive vrednosti so odvisne od ponudnika brez vrste. Za JSON se pričakuje, da bo predmet brez vrste niz JSON, ki vsebuje datum in čas v obliki zapisa ISO 8601. Datumi ali časi v drugih oblikah zapisa bodo povzročili napako. Takšne vrednosti najprej pretvorite v Besedilo in nato v datum ali čas. Pri komunikaciji z zunanjimi sistemi upoštevajte, da so časovni pasovi in oblike zapisov, povezane z območnimi nastavitvami, pomemben dejavnik.

Primeri

DateValue

Če vnesete 10/11/2014 v kontrolnik za vnos besedila, imenovan Startdate, nato pa nastavite lastnost Besedilo oznake na te formule:

  • Pretvorite datum iz niza v uporabnikovih območnih nastavitvah in prikažite rezultat kot dolgi datum.

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

    Naprava, nastavljena na območne nastavitve en, prikaže oznako kot Saturday, October 11, 2014.

    opomba,

    Uporabite lahko več možnost z enumeratorjem DateTimeFormat. Za prikaz seznama možnosti vnesite parameter, za njim pa piko ali vejico (.) v vnosno polje ali preverite informacije o funkciji Text.

  • Pretvorite datum iz niza v slovenskih območnih nastavitvah in prikažite rezultat kot dolgi datum. V tem primeru sta mesec in dan v mesecu drugače interpretirana kot v angleščini.

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

    Naprava, nastavljena na območne nastavitve en, prikaže oznako kot Monday, November 10, 2014.

Če ste vnesli October 20, 2014:

  • Pretvorite datum iz niza v uporabnikovih območnih nastavitvah in izračunajte razliko med dvema dnevoma v dnevih

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

    Naprava, nastavljena na območne nastavitve en, prikaže oznako kot 9, kar označuje število dni med 11. oktobrom in 20. oktobrom. Funkcija DateDiff lahko prikaže tudi razliko v mesecih, četrtletjih ali letih.

DateTimeValue

Če ste vnesli 10/11/2014 1:50:24.765 PM v kontrolnik za vnos besedila, imenovan Start, nato pa nastavili lastnost Besedilo oznake na to formulo:

  • Pretvorite datumski in časovni niz v trenutno območje.

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

    Naprava, nastavljena na območne nastavitve en, prikaže oznako kot Saturday, October 11, 2014 1:50:24 PM.

    opomba,

    Uporabite lahko več možnost z enumeratorjem DateTimeFormat. Za prikaz seznama možnosti vnesite parameter, za njim pa piko ali vejico (.) v vnosno polje ali preverite informacije o funkciji Text.

  • Pretvorite datumski in časovni niz v slovensko območje. Mesec in dan v mesecu sta interpretirana drugače.

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

    Naprava, nastavljena na območne nastavitve en, prikaže oznako kot Monday, November 10, 2014 1:50:24 PM.

  • Pretvorite datumski in časovni niz v uporabnikovo območje ter prikažite rezultat s polno sekundo.

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

    Naprava, nastavljena na območne nastavitve en, prikaže oznako kot Saturday, October 11, 2014 01:50:24.765 PM.

    Kot alternativo lahko navedete hh:mm:ss.f ali hh:mm:ss.ff, da zaokrožite čas na najbližjo desetinko ali stotinko sekunde.

TimeValue

Poimenujte kontrolnik za vnos besedila FinishedAt, nato pa nastavite lastnost Besedilo oznake na to formulo:

If( TimeValue( FinishedAt.Text ) < TimeValue( "5:00:00.000 PM" ),
    "You made it!",
    "Too late!"
)
  • Če vnesete 4:59:59.999 PM v kontrolnik FinishedAt, oznaka prikaže »You made it!«.
  • Če vnesete 5:00:00.000 PM v kontrolnik FinishedAt, oznaka prikaže »Too late!«.