Funktsioonid Date, DateTime ja Time

  • Artikkel

Kehtib: Lõuendirakendused Töölauavood Mudelipõhised rakendused Power Platform CLI

Teisendab kuupäeva ja kellaaja komponendid kuupäeva/kellaaja väärtuseks.

Kirjeldus

Funktsioon Date teisendab üksiku aasta, kuu ja päeva väärtused kuupäeva/kellaaja väärtuseks. Ajaosa on kesköö.

  • Kui aasta on vahemikus 0 kuni 1899 (kaasa arvatud), lisab funktsioon selle väärtuse 1900-le, et arvutada aasta. 70 muutub 1970-ks.
  • Kui kuu on väiksem kui 1 või suurem kui 12, siis tulemus lahutab või lisab sama palju kuid määratud aasta algusest.
  • Kui Päev on suurem kui määratud kuu päevade arv, lisab funktsioon nii mitu päeva kuu esimesele päevale ja tagastab vastava kuupäeva järgnevast kuust. Kui Päev on väiksem kui 1, lahutab funktsioon määratud kuu esimesest päevast nii mitu päeva pluss 1.

Funktsioon Time teisendab tunni, minuti, sekundi ja soovi korral millisekundi väärtused kuupäeva/kellaaja väärtuseks. Tulemusel pole sellega seostatud kuupäeva.

Funktsioon DateTime ühendabkuupäeva- ja kellaajafunktsioonid üheks funktsiooniks, võttes nii kuupäeva- kui ka kellaajaargumendid ning tagastades kuupäeva/kellaaja väärtuse, mis sisaldab nii kuupäeva- kui ka kellaajakomponente .

Vt funktsioone DateValue, TimeValue ja DateTimeValue, et saada teavet, kuidas teisendada stringi väärtuseks.

Vt ka lisateavet kuupäevade ja kellaaegadega töötamise kohta.

Süntaks

Date( Year, Month, Day )

  • Year – nõutav. Suuremaid numbreid kui 1899 tõlgendatakse absoluutsena (1980 tõlgendatakse kui 1980); numbreid, mis jäävad vahemikku 0-1899, tõlgendatakse võrreldes 1900-ga. (Näiteks 80 tõlgendatakse kui 1980.)
  • Month – nõutav. Arv, mis jääb vahemikku 1-12.
  • Day – nõutav. Arv, mis jääb vahemikku 1-31.

Aeg( tund;minut ;sekund [ , millisekundid ] )

  • Hour – nõutav. Tundide arv, tavaliselt vahemikus 0 (12:00 AM) kuni 23 (11:00 PM).
  • Minut – nõutav. Minutite arv, tavaliselt vahemikus 0 kuni 59.
  • Second – nõutav. Sekundite arv, tavaliselt vahemikus 0 kuni 59.
  • Millisekundid - valikuline. Millisekundite arv, tavaliselt vahemikus 0 kuni 999.

DateTime(aasta;kuu,päev,tund,minut,sekund[,millisekundid] )

  • Year – nõutav. Suuremaid numbreid kui 1899 tõlgendatakse absoluutsena (1980 tõlgendatakse kui 1980); numbreid, mis jäävad vahemikku 0-1899, tõlgendatakse võrreldes 1900-ga. (Näiteks 80 tõlgendatakse kui 1980.)
  • Month – nõutav. Arv, mis jääb vahemikku 1-12.
  • Day – nõutav. Arv, mis jääb vahemikku 1-31.
  • Hour – nõutav. Tundide arv, tavaliselt vahemikus 0 (12:00) kuni 23 (23:00 PM)
  • Minut – nõutav. Minutite arv, tavaliselt vahemikus 0 kuni 59.
  • Second – nõutav. Sekundite arv, tavaliselt vahemikus 0 kuni 59.
  • Millisekundid - valikuline. Millisekundite arv, tavaliselt vahemikus 0 kuni 999.

Näited

Date

Kui kasutaja on tippinud

  • 1979 tekstisisestuse juhtelemendis nimega HireYear
  • 3 tekstisisestuse juhtelemendis nimega HireMonth
  • 17 tekstisisestuse juhtelemendis nimega HireDay

See valem tagastaks 3/17/1979:

Date( Value(HireYear.Text), Value(HireMonth.Text), Value(HireDay.Text) )

Aeg

Kui kasutaja on tippinud

  • 14 tekstisisestuse juhtelemendis nimega BirthHour
  • 50 tekstisisestuse juhtelemendis nimega BirthMinute
  • 24 tekstisisestuse juhtelemendis nimega BirthSecond

See valem tagastaks 02:50:24 P:

Text( 
    Time(Value(BirthHour.Text), Value(BirthMinute.Text), Value(BirthSecond.Text)), 
    "hh:mm:ss A/P" 
)

DateTime

Kui kasutaja on tippinud

  • 2023 tekstisisestuse juhtelemendis nimega EclipseYear
  • 10 tekstisisestuse juhtelemendis nimega EclipseMonth
  • 28 tekstisisestuse juhtelemendis nimega EclipseDate
  • 13 tekstisisestuse juhtelemendis nimega EclipseHour
  • 14 tekstisisestuse juhtelemendis nimega EclipseMinute
  • 5 tekstisisestuse juhtelemendis nimega EclipseSecond
  • 231 tekstisisestuse juhtelemendis nimega EclipseMillisecond

See valem tagastaks 10/28/23 01:14:05.231 PM:

Text(
    DateTime(Value(EclipseYear.Text), Value(EclipseMonth.Text), Value(EclipseDate.Text), 
        Value(EclipseHour.Text), Value(EclipseMinute.Text), 
        Value(EclipseSecond.Text), Value(EclipseSecond.Millisecond)
    ), 
    "yy/mm/dd hh:mm:ss.000 AM/PM"
)