Funktionerne Now, Today, IsToday, UTCNow, UTCToday, IsUTCToday

Gælder for: Lærredapps Formelkolonner Dataverse for skrivebordsflow CLI Modelbaserede apps Power Pages Power Platform CLI

Returnerer den aktuelle dato og det aktuelle klokkeslæt og undersøger, om en værdi for dato og klokkeslæt er i dag.

Bemærk

PAC CLI pac power-fx-kommandoer understøtter ikke funktionerne UTCNow, UTCToday og IsUTCToday .

Beskrivelse

Funktionen Now returnerer den aktuelle dato og det aktuelle klokkeslæt som en værdi for dato og klokkeslæt.

Funktionen Today returnerer den aktuelle dato som en værdi for dato og klokkeslæt. Klokkeslætsdelen er midnat. I dag har den samme værdi i løbet af en dag, fra midnat i dag til midnat i morgen.

Funktionen IsToday undersøger, om en værdi for dato og klokkeslæt er mellem midnat i dag og midnat i morgen. Denne funktion returnerer en boolesk værdi sand eller falsk.

Now, Today og IsToday funktioner fungerer med den aktuelle brugers lokale tid.

Funktionerne UTCNow, UTCToday og IsUTCToday er de samme som deres ikke-UTC-modstykker, men arbejder med tidszoneuafhængige værdier og bruger UTC (Coordinated Universal Time).

Bemærk

• UTCNow,UTCToday og IsUTCToday er kun tilgængelige i Microsoft Dataverse for Teams formelkolonner og kun for tidsuafhængige felter og værdier.
• Now,Today og IsToday er ikke tilgængelige i Dataverse for Teams formelkolonner, da evalueringer udføres uden kendskab til den aktuelle brugers lokale tidszone.
  Flere oplysninger: Arbejde med kolonner i formeltabel i Dataverse for Teams

Se yderligere oplysninger i Dato, Klokkeslæt og DateTime i dokumentationen til datotyper og arbejde med datoer og klokkeslæt.

Flygtige funktioner

Nu,I dag,UTCNow og UTCToday er flygtige funktioner. Disse funktioner returnerer en anden værdi for hver evaluering.

Når en flygtig funktion bruges i en dataflowformel, returneres der kun en anden værdi, hvis den formel, som den bruges i, evalueres igen. Hvis intet andet ændres i formlen, vil den have den samme værdi under hele udførelsen af din app.

Et etiket-kontrolelement med Label1.Text = Now() ændres f.eks. ikke, mens appen er aktiv. Der kommer først en ny værdi, når du lukker og åbner appen igen.

Funktionen evalueres igen, hvis den er del af en formel, hvor der er blevet ændret noget andet. Hvis vi f.eks. ændrer vores eksempel til at omfatte et skyder-kontrolelement med Label1.Text = DateAdd( Now(), Slider1.Value, Minutes ), så hentes det aktuelle klokkeslæt, hver gang værdien for skyder-kontrolelementet ændrer sig, og kontrolelementets tekstegenskab evalueres igen.

Når flygtige funktioner bruges i en funktionsformel, evalueres de, hver gang funktionsformlen evalueres. Se et eksempel herunder.

Syntaks

Bruge brugerens lokale tidszone

Nu()

I dag()

ErI dag( Dato/klokkeslæt )

• DateTime – påkrævet. Den værdi for dato og klokkeslæt, der skal testes.

Brug af Coodinated Universal Time (UTC)-tid

UTCNow()

UTCToday()

IsUTCToday( TimeZoneIndependentTime )

• TimeZoneIndependentDateTime – Påkrævet. Den tidszoneuafhængige værdi for dato/klokkeslæt, der skal testes.

Eksempler

I forbindelse med eksemplerne i dette afsnit er det aktuelle klokkeslæt 8:58 den 11. juli 2021 i tidszone for stillehavsområdet (UTC-8), og sproget er en-us.

Formel	Beskrivelse	Resultat
Tekst( Now(), "mm/dd/åååå tt:mm:ss" )	Henter den aktuelle dato og den aktuelle bruger tidszone og viser den som en streng.	"11-07-2021 20:58:00"
Tekst( I dag(), "mm/dd/åååå tt:mm:ss" )	Henter kun den aktuelle dato, hvor klokkeslætsdelen bliver stående som midnat, og viser den som en streng.	"12-07-2021 00:00:00"
IsToday( Now() )	Tester, om den aktuelle dato og det aktuelle klokkeslæt er mellem midnat i dag og midnat i morgen.	sand
IsToday( Today() )	Tester, om den aktuelle dato er mellem midnat i dag og midnat i morgen.	sand
Tekst( DateAdd( Now(), 12 ), "mm/dd/åååå tt:mm:ss" )	Henter den aktuelle dato og det aktuelle klokkeslæt, lægger 12 dage til resultatet og viser den som en streng.	"23-07-2021 20:58:00"
Tekst( DateAdd( Today(), 12 ), "mm/dd/åååå tt:mm:ss" )	Henter den aktuelle dato, lægger 12 dage til resultatet og viser den som en streng.	"23-07-2021 00:00:00"
IsToday( DateAdd( Now(), 12 ) )	Tester, om den aktuelle dato og det aktuelle klokkeslæt plus 12 dage er mellem midnat i dag og midnat i morgen.	falsk
IsToday( DateAdd( Today(), 12 ) )	Tester, om den aktuelle dato plus 12 dage er mellem midnat i dag og midnat i morgen.	falsk
Time( UTCNow() )	Henter den aktuelle dato og det aktuelle klokkeslæt i UTC og udtrækker kun timen, som er 8 timer forud for lokal tid.	4
Dag( UTCToday() )	Henter kun dags dato i UTC og udtrækker kun dagen, som er 1 dag forud for lokal tid.	12
IsUTCToday( UTCNow() )	Tester, om den aktuelle dato og det aktuelle klokkeslæt er mellem midnat i dag og midnat i morgen, alt i UTC-tidszoneformat.	sand
IsUTCToday( UTCToday() )	Tester, om den aktuelle dato er mellem midnat i dag og midnat i morgen, alt i UTC-tidszoneformat.	sand

Vis et ur med opdateringer i realtid

1. Tilføj et Timer-kontrolelement , indstil dets Duration-egenskab til 1000, og indstil dets Repeat-egenskab til sand.

   Timeren vil køre i ét sekund, starte forfra automatisk og fortsætte dette mønster.

2. Angiv kontrolelementets OnTimerEnd-egenskab til denne formel:

   Indstil ( CurrentTime, Nu() )

   Hver gang timeren starter forfra (efter hvert sekund), indstiller denne formel den globale variabel CurrentTime til den aktuelle værdi for funktionen Now.

   

3. Tilføj et Label-kontrolelement, og indstil dets Text-egenskab til denne formel:

   Tekst( CurrentTime, LongTime24 )

   Brug funktionen Text til at formatere dato og klokkeslæt, som du vil, eller angiv blot denne egenskab til CurrentTime for at få vist timer og minutter, men ikke sekunder.

   

4. Få vist appen ved at trykke på F5, og start derefter timeren ved at klikke på den.

   Etiketten viser løbende det aktuelle klokkeslæt ned til sekundet.

   

5. Angiv egenskaben AutoStart for timeren til sand og egenskaben Visible til falsk.

   Timeren er usynlig og starter automatisk.

6. Angiv skærmbilledets OnStart-egenskab, så variablen CurrentTime indeholder en gyldig værdi, som i dette eksempel:

   Indstil (Aktuel tid, Nu())

   Etiketten vises, når appen startes (før timeren kører et helt sekund).