Now, Today, IsToday, UTCNow, UTCToday, IsUTCToday függvények

  • Cikk

A következőkre vonatkozik: Vászonalapú alkalmazások Asztali folyamatok képletoszlopai Dataverse Modellvezérelt alkalmazások Power Platform CLI

Az aktuális dátumot és időt adja vissza, és teszteli, hogy a dátum/idő érték a mainak felel-e meg.

Feljegyzés

A PAC CLI PAC POWER-FX parancsok nem támogatják az UTCNow, UTCToday ésIsUTCToday függvényeket.

Description

A Now függvény dátum/idő értékként adja vissza az aktuális dátumot és időt.

A Today függvény dátum/idő értékként adja vissza az aktuális dátumot. Az időpont összetevő éjfél. A Today egész nap ugyanazzal az értékkel rendelkezik, ma éjféltől holnap éjfélig.

Az IsToday függvény teszteli, hogy a dátum/idő érték ma éjfél és holnap éjfél közötti-e. Ez a függvény logikai, azaz (igaz vagy hamis) értéket ad vissza.

A Now, Today és IsToday függvények az aktuális felhasználó helyi idejét használják.

Az UTCNow, UTCToday és IsUTCToday függvények megegyeznek a nem UTC megfelelőikkel, de időzónától független értékekkel működnek, és az egyezményes világidőt (UTC) használják.

Feljegyzés

  • Az UTCNow, UTCToday és IsUTCToday csak a Microsoft Dataverse for Teams képletek oszlopaihoz érhető el, és kizárólag időtől független mezőkhöz és értékekhez.
  • A Now, Today és IsToday nem érhető el a Dataverse for Teams képletek oszlopaihoz, mivel az értékelést a rendszer az aktuális felhasználó helyi időzónája ismerete nélkül végzi.
    További információ: Képlettáblaoszlopok használata a Dataverse for Teams szolgáltatásban

További információ: Date, Time és DateTime adattípusok dokumentációja, valamint Dátumok és időpontok használata.

Környezetfüggő függvények

A Now, Today, UTCNow és UTCToday függvények környezetfüggő függvények. A függvények minden egyes kiértékelés során más értéket adnak vissza.

Ha egy adatfolyamképletben környezetfüggő függvényt használ, akkor a függvény csak akkor fog más értéket visszaadni, ha újraértékeli a képletet, amelyben a függvény szerepel. Ha a képletben semmi más nem változik, akkor az az alkalmazás futásának teljes idején ugyanazzal az értékkel fog visszatérni.

Például egy Label1.Text = Now() függvényt tartalmazó címke nem fog megváltozni, amíg az alkalmazás aktív. Új érték csak akkor jelenik meg, ha az alkalmazást bezárják, majd újra megnyitják.

A rendszer újraértékeli a függvényt, ha az egy olyan képlet része, amelyben valami más módosult. Ha a példánkat úgy módosítjuk, hogy felveszünk benne egy Label1.Text = DateAdd( Now(), Slider1.Value, Minutes ) képletet, akkor a rendszer lekérdezi az aktuális időt minden olyan alkalommal, amikor a csúszka vezérlőelem értéke módosul, és a címke értéke újra ki lesz értékelve.

Viselkedési képletben használva a volatilis függvények minden egyes kiértékelésénél újra ki lesznek értékelve. Erre alább látható példa.

Szintaxis

A felhasználó helyi időzónájának használata

Most()

Ma()

IsToday( DateTime )

  • DateTime – Kötelező. A tesztelendő dátum/idő érték.

Egyezményes világidő (UTC) használata

UTCNow()

UTCToday()

IsUTCToday( TimeZoneIndependentTime )

  • TimeZoneIndependentDateTime – Kötelező. A tesztelni kívánt időzónától független dátum/idő értéke.

Példák

Az ebben a szakaszban található példák esetében az aktuális idő 20:582021 . július 11., az időzóna a csendes-óceáni időzóna (UTC-8), a nyelv pedig en-us.

Képlet Description Result
Text( Now(), "mm/dd/yyyy hh:mm:ss" ) Lekérdezi az aktuális dátumot és időt a felhasználó időzónájában, és sztringként jeleníti meg azt. "07/11/2021 20:58:00"
Text( Today(), "mm/dd/yyyy hh:mm:ss" ) Lekérdezi az aktuális dátumot, miközben az időpont összetevő éjfél értéken marad, és megjeleníti sztringként. "07/12/2021 00:00:00"
IsToday( Now() ) Teszteli, hogy az aktuális dátum és idő ma éjfél és holnap éjfél közötti-e. true
IsToday( Today() ) Teszteli, hogy az aktuális dátum ma éjfél és holnap éjfél közötti-e. true
Text( DateAdd( Now(), 12 ), "mm/dd/yyyy hh:mm:ss" ) Lekérdezi az aktuális dátumot és időt, hozzáad 12 napot az eredményhez, és sztringként jeleníti meg. "07/23/2021 20:58:00"
Text( DateAdd( Today(), 12 ), "mm/dd/yyyy hh:mm:ss" ) Lekérdezi az aktuális dátumot, hozzáad 12 napot az eredményhez, és sztringként jeleníti meg. "07/23/2021 00:00:00"
IsToday( DateAdd( Now(), 12 ) ) Teszteli, hogy az aktuális dátum és idő plusz 12 nap ma éjfél és holnap éjfél közötti-e. false
IsToday( DateAdd( Today(), 12 ) ) Teszteli, hogy az aktuális dátum plusz 12 nap ma éjfél és holnap éjfél közötti-e. false
Hour( UTCNow() ) Lekéri az aktuális dátumot és időpontot UTC-ben, és csak az órát nyeri ki, ami 8 órával a helyi idő előtt van. 4
Day( UTCToday() ) Csak az aktuális dátumot olvassa be UTC szerint, és kinyeri a napot, amely 1 nappal megelőzi a helyi időt. 12
IsUTCToday( UTCNow() ) Teszteli, hogy az aktuális dátum és idő ma éjfél és holnap éjfél közötti-e, UTC-ben. true
IsUTCToday( UTCToday() ) Teszteli, hogy az aktuális dátum ma éjfél és holnap éjfél közötti-e, UTC-ben. true

Valós időben frissülő óra megjelenítése

  1. Adjon hozzá egy Időmérő vezérlőelemet, állítsa az Időtartam tulajdonságot 1000 értékre, az Ismétlés tulajdonságát pedig igaz értékre.

    Az időmérő egy másodpercig fog futni, automatikusan újraindul, és ezt a mintát követi.

  2. Állítsa a vezérlő OnTimerEnd tulajdonság értékét erre a képletre:

    Set( CurrentTime, Now() )

    Ez a képlet a CurrentTime globális változót minden egyes alkalommal, amikor az időmérő újraindul (azaz másodpercenként) a Now függvény aktuális értékére állítja.

    Képernyőkép az OnTimerEnd = Set(CurrentTime, Now()) képletet tartalmazó időmérő vezérlőelemmel.

  3. Adjon hozzá egy Címke vezérlőelemet, és a Szöveg tulajdonságát állítsa a következő képletre:

    Text( CurrentTime, LongTime24 )

    A dátum és idő formátumát a Text függvény használatával tetszés szerint beállíthatja, vagy beállíthatja ezt a tulajdonságot egyszerűen a CurrentTime értékre, amellyel órát és percet jeleníthet meg másodpercek nélkül.

    Képernyőkép a címke vezérlőelemmel, melyben a Text tulajdonság értéke Text( CurrentTime, LongTime24).

  4. Az alkalmazás előnézetét az F5 billentyű megnyomásával tekintheti meg, az időmérőt pedig kattintással vagy koppintással indíthatja el.

    A címke másodperces pontossággal folyamatosan megjeleníti az aktuális időt.

    Négy képernyőkép négyféle időértékkel (13:50:22, 13:50:45, 13:51:03 és 13:51:25).

  5. Állítsa az AutoStart tulajdonságot igaz értékűre, a Látható tulajdonságot pedig hamis értékűre.

    Az időmérő így láthatatlan lesz, és automatikusan indul.

  6. A képernyő OnStart tulajdonságát állítsa be úgy, hogy a CurrentTime változó érvényes értékkel rendelkezzen, ahogy az alábbi példában látható:

    Set(CurrentTime, Now())

    A címke az alkalmazás indulásakor azonnal megjelenik (mielőtt az időmérő egy teljes másodpercig futna).