Nüüd, täna, IsToday, UTCNow, UTCToday, IsUTCToday funktsioonid

Kehtib: lõuendirakendused Töölauavoogude Dataverse valemiveerud Mudelipõhised rakendused Power Platform CLI

Tagastab tänase kuupäeva ja kellaaja ning testib, kas kuupäeva/kellaaja väärtus on täna.

Kirjeldus

Funktsioon Now tagastab tänase kuupäeva ja kellaaja väärtuse.

Funktsioon Today tagastab tänase kuupäeva ja kellaaja väärtuse. Ajaosa on kesköö. Funktsioonil Today on sama väärtus kogu päeva jooksul, keskööst homse keskööni.

IsToday funktsiooni abil saab kontrollida, kas kuupäeva/kellaaja väärtus on täna kesköö ja homme kesköö vahel. Funktsioon tagastab loogikaväärtuse (tõene või väär).

Funktsioonid Now, Today jaIsToday töötavad praeguse kasutaja kohaliku ajaga.

UTCNow, UTCToday ja IsUTCToday funktsioonid on samad, mis nende mitte-UTC kolleegidel, kuid töötavad ajavööndist sõltumatute väärtustega ja kasutavad koordineeritud maailmaaega (UTC).

Lisateavet leiate teemadest Kuupäev, Kellaaeg ja DateTime andmetüüpide dokumentatsioonis ning jaotisest kuupäevade ja kellaaegadega töötamine.

Lendfunktsioonid

Now, Today, UTCNow ja UTCToday on lendfunktsioonid. Iga hinnangu korral tagastavad need funktsioonid erineva väärtuse.

Kui kasutatakse andmevoo valemis, tagastab lendfunktsioon teistsuguse väärtuse vaid juhul, kui valem, milles see kuvatakse, on uuesti hinnatud. Kui valemis ei muutu miski muu, on sellel teie rakenduse käitamisel sama väärtus.

Näiteks juhtelement silt koos Label1.Text = Now() ei muutu, kui teie rakendus on aktiivne. Ainult rakenduse sulgemine ja uuesti avamine toob kaasa uue väärtuse.

Funktsiooni hinnatakse uuesti juhul, kui see on osa valemist, milles on midagi muud muutunud. Näiteks, kui muudame näidet, et kaasata juhtelement liugur valemiga Label1.Text = DateAdd( Now(), Slider1.Value, Minutes ), siis praegune aeg tuuakse iga kord, kui juhtelemendi liugur väärtus muutub ja sildi tekstiatribuut hinnatakse uuesti.

Kui kasutatakse käitumise vaemis, hinnatakse lendfunktsioone iga kord, kui käitumisvalemit hinnatakse. Vt allpool näidet.

Süntaks

Kasutaja kohaliku kellaaja kasutamine

Now()

Today()

IsToday( DateTime )

• DateTime – nõutav. Testitav kuupäeva/kellaaja väärtus.

Koordineeritud maailmaaja (UTC) kasutamine

UTCNow()

UTCToday()

IsUTCToday( TimeZoneIndependentTime )

• TimeZoneIndependentDateTime – nõutav. Testitav ajavööndist sõltumatu kuupäeva/kellaaja väärtus.

Näited

Selles jaotises toodud näidete puhul on praegune kellaaeg 20.5811. juulil 2021 Vaikse ookeani ajavööndis (UTC-8) ja keeleks on en-us.

Kuva reaalajas värskendatav kell

1. Lisage juhtelement taimer, seadke selle atribuut Kestus väärtusele 1000 seadke atribuut kordamine väärtusele tõene.

   Taimer käivitub hetkega, käivitub automaatselt uuesti ja jätkab seda mustrit.

2. Seadke juhtelemendi atribuut OnTimerEnd valemile:

   Set( CurrentTime, Now() )

   Kui taimer käivitub üle (pärast iga sekundit), seab see valem globaalse uutuja CurrentTime praegusele väärtusele funktsiooniga Now.

   

3. Lisage juhtelement silt ja seadke selle atribuut Tekst valemile:

   Text( CurrentTime, LongTime24 )

   Kasutage funktsiooni Text, et vormindada soovitud kuupäeva ja kellaaega, või määrake selleks atribuudiks lihtsalt CurrentTime, et kuvada tunnid ja minutid, kuid mitte sekundid.

   

4. Rakenduse eelvaate kuvamine, vajutades klahvi F5, ja seejärel käivitage taimer, klõpsates või koputades seda.

   Silt näitab pidevalt praegust kellaaega, sekundini.

   

5. Seadke taimeri atribuudi AutoStart väärtuseks tõene ja selle atribuut Nähtav väärtuseks väär.

   Taimer on nähtamatu ja käivitub automaatselt.

6. Seadke ekraani atribuut OnStart nii, et muutujal CurrentTime oleks sobiv väärtus, nagu käesolevas näites.

   Set(CurrentTime, Now())

   Silt kuvatakse kohe pärast rakenduse käivitamist (enne taimeri töötamist ühe sekundi).