Now-, Today-, IsToday-, UTCNow-, UTCToday- ja IsUTCToday-funktio

Koskee seuraavia: pohjaan perustuvat sovellukset Työpöytätyönkulkujen Dataverse kaavasarakkeet Mallipohjaisten sovellusten Power Pages Power Platform CLI

Palauttaa nykyisen päivämäärän ja ajan ja testaa, vastaako päivämäärä/aika-arvo tätä päivää.

Muistiinpano

PAC CLI pac power-fx -komennot eivät tue UTCNow -, UTCToday - jaIsUTCToday-funktioita .

Description

Now-funktio palauttaa nykyisen päivämäärän ja ajan päivämäärä/aika-arvona.

Today-funktio palauttaa nykyisen päivämäärän päivämäärä/aika-arvona. Aikaosa vastaa keskiyötä. Tänään on sama arvo koko päivän, keskiyöstä tänään keskiyöhön huomenna.

IsToday-funktiolla testataan, onko päivämäärä/aika-arvo tämän päivän keskiyön ja huomisen keskiyön välillä. Tämä funktio palauttaa totuusarvon (true tai false).

Now,Today - ja IsToday-funktiot toimivat nykyisen käyttäjän paikallisen ajan kanssa.

UTCNow-, UTCToday - jaIsUTCToday-funktiot ovat samat kuin niiden ei-UTC-funktiot, mutta ne toimivat aikavyöhykkeestä riippumattomien arvojen kanssa ja käyttävät koordinoitua yleisaikaa (UTC).

Muistiinpano

• UTCNow,UTCToday ja IsUTCTodayovat käytettävissä vain kaavasarakkeissa ja vain ajasta riippumattomissa kentissä ja arvoissa. Microsoft Dataverse for Teams
• Now,Today , ja IsToday eivät ole käytettävissä kaavasarakkeissa , Dataverse for Teams koska arvioinnit tehdään tietämättä nykyisen käyttäjän paikallista aikavyöhykettä.
  Lisätietoja: Dataverse for Teamsin kaavataulukon sarakkeiden käsitteleminen

Lisätietoja on päivämäärä-, aika- ja päivämäärä/aika-tietotyyppien ohjeissa ja Päivämäärien ja kellonaikojen käsitteleminen -kohdassa.

Muuttuvat funktiot

Nyt, tänään, UTCNow ja UTCToday ovat haihtuvia funktioita. Nämä toiminnot palauttavat eri arvon kullekin arvioinnille.

Kun muuttuvaa funktiota käytetään tietotyönkulun kaavassa, muuttuva funktio palauttaa eri arvon vain arvioitaessa uudelleen kaavaa, jossa se esiintyy. Jos mitään muuta ei muuteta kaavassa, sillä on sama arvo koko sovelluksesi suorittamisen ajan.

Esimerkiksi nimen ohjausobjekti, jossa Label1.Text = Now(), ei muutu, kun sovelluksesi on aktiivinen. Uusi arvo luodaan vain sulkemalla sovellus ja avaamalla se uudelleen.

Funktio arvioidaan uudelleen, jos se on osa kaavaa, jossa jotakin muuta kohtaa on muutettu. Jos lisäämme esimerkkiimme slider-ohjausobjektin, jossa Label1.Text = DateAdd (Now(), Slider1.Value, Minutes), senhetkinen aika noudetaan aina, kun Slider-ohjausobjektin arvo muuttuu ja otsikon tekstin ominaisuutta arvioidaan uudelleen.

Kun sitä käytetään käytöskaavassa, muuttuvia funktioita arvioidaan aina, kun käytöskaavaa arvioidaan. Katso esimerkki alta.

Syntaksi

Käyttäjän paikallisen ajan käyttäminen

Nyt()

Tänään()

IsToday( DateTime )

• DateTime - pakollinen. Testattava päivämäärä/aika-arvo.

Käytetään UTC-aikaa

UTCNow()

UTCToday()

IsUTCToday( TimeZoneIndependentTime )

• TimeZoneIndependentDateTime - pakollinen. Aikavyöhykkeen testattava itsenäinen päivämäärä/aika-arvo.

Esimerkkejä

Tässä osassa on esimerkkejä, joissa nykyinen aika on 8:58 PM 11.7.2021, Tyynenmeren aikavyöhyke (UTC-8), ja kieli on en-us.

Kaava	Kuvaus	Tulos
Text( Now(), "kk/pp/v hh:mm:ss" )	Hakee nykyisen päivämäärän ja ajan käyttäjän aikavyöhykkeessä ja näyttää tuloksen merkkijonona.	"07/11/2021 20:58:00"
Text( Today(), "mm/pp/yyyy hh:mm:ss" )	Hakee vain nykyisen päivämäärän, jättää aikaosan keskiyöhön ja näyttää tuloksen merkkijonona.	"07/12/2021 00:00:00"
IsToday( Now() )	Testaa, onko nykyinen päivämäärä ja aika tämän päivän keskiyön ja huomisen keskiyön välillä.	tosi
IsToday( tänään() )	Testaa, onko nykyinen päivämäärä tämän päivän keskiyön ja huomisen keskiyön välillä.	tosi
Text( DateAdd( Now(), 12 ), "mm/dd/yyyy hh:mm:ss" )	Hakee nykyisen päivämäärän ja ajan, lisää tulokseen 12 päivää ja näyttää tuloksen merkkijonona.	"07/23/2021 20:58:00"
Text( DateAdd( Today(), 12 ), "kk/pp/v hh:mm:ss" )	Hakee nykyisen päivämäärän, lisää tulokseen 12 päivää ja näyttää tuloksen merkkijonona.	"07/23/2021 00:00:00"
IsToday( DateAdd( Now(), 12 ) )	Testaa, onko nykyinen päivämäärä ja aika plus 12 päivää tämän päivän keskiyön ja huomisen keskiyön välillä.	väärä
IsToday( DateAdd( Today(), 12 ) )	Testaa, onko nykyinen päivämäärä plus 12 päivää tämän päivän keskiyön ja huomisen keskiyön välillä.	väärä
Tunti( UTCNow() )	Hakee nykyisen päivämäärän ja ajan UTC-aikana ja poimii vain tunnin, joka on 8 tuntia edellä paikallista aikaa.	4
Päivä( UTCToday() )	Hakee vain nykyisen päivämäärän UTC-aikana ja poimii päivän, joka on 1 päivä edellä paikallista aikaa.	12
IsUTCToday( UTCNow() )	Testaa, onko nykyinen päivämäärä ja aika tämän päivän keskiyön ja huomisen keskiyön välillä UTC-ajassa.	tosi
IsUTCToday( UTCToday() )	Testaa, onko nykyinen päivämäärä tämän päivän keskiyön ja huomisen keskiyön välillä UTC-ajassa.	tosi

Reaaliaikaisesti päivittyvän kellon näyttäminen

1. Lisää Timer-ohjausobjekti, määritä sen Duration-ominaisuuden arvoksi 1 000 ja sen Repeat-ominaisuudeksi true.

   Ajastin käy sekunnin ja aloittaa automaattisesti alusta jatkaen tätä mallia.

2. Määritä ohjausobjektin OnTimerEnd-ominaisuus tähän kaavaan:

   Aseta ( CurrentTime, Now () )

   Aina, kun ajastin aloittaa alusta (jokaisen sekunnin jälkeen), tämä kaava määrittää yleisen CurrentTime-muuttujan Now-funktion nykyiseen arvoon.

   

3. Lisää Label-ohjausobjekti ja määritä sen Text-ominaisuudeksi seuraava kaava:

   Teksti( CurrentTime, LongTime24 )

   Voit Text-funktion avulla muotoilla päivämäärän ja ajan haluamaksesi tai määrittää täksi ominaisuudeksi CurrentTime, jotta se näyttää tunnit ja minuutit sekuntien sijasta.

   

4. Voit esikatsella sovellusta painamalla F5 ja käynnistää sitten ajastimen napsauttamalla tai napauttamalla sitä.

   Selite näyttää jatkuvasti senhetkisen ajan sekunteihin asti.

   

5. Määritä ajastimen AutoStart-ominaisuudeksi true ja Visible-ominaisuudeksi false.

   Ajastin on näkymätön ja käynnistyy automaattisesti.

6. Määritä näytön OnStart-ominaisuus, jotta CurrentTime-muuttujalla on voimassaoleva arvo, kuten seuraavassa esimerkissä:

   Set(CurrentTime, Now())

   Selite tulee näkyviin heti, kun sovellus käynnistyy (ennen kuin ajastin käy koko sekunnin ajan).