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

Gælder for: Lærredsapps Skrivebordsflows Dataverse formelkolonner Modeldrevne apps 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.

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. Today har 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.

Funktionerne Now,Today og IsToday fungerer nu sammen med den aktuelle brugers lokale tidspunkt.

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

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

Flygtige funktioner

Now, Today, 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

Now()

Today()

IsToday( DateTime )

• 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.

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:

   Set( CurrentTime, Now() )

   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:

   Text( 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:

   Set( CurrentTime, Now())

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