Funktionen „Now“, „Today“, „IsToday“, „UTCNow“ und „UTCToday“, „IsUTCToday“

Gilt für: Canvas-Apps Desktop-Flows Dataverse Formelspalten Modellgesteuerte Apps Power Platform CLI

Gibt das aktuelle Datum und die Uhrzeit zurück und prüft, ob ein Datum/Uhrzeit-Wert heute ist.

Description

Die Now-Funktion gibt das aktuelle Datum und die Uhrzeit als Datum/Uhrzeit-Wert zurück.

Die Today-Funktion gibt das aktuelle Datum als Datum/Uhrzeit-Wert zurück. Der Uhrzeitanteil ist Mitternacht. Today hat den gesamten Tag (ab Mitternacht heute bis Mitternacht morgen) den gleichen Wert.

Die IsToday-Funktion testet, ob ein Datum/Uhrzeit-Wert zwischen Mitternacht heute und Mitternacht morgen liegt. Diese Funktion gibt einen booleschen Wert zurück (TRUE oder FALSE).

Now, Today, und IsToday Funktionen arbeiten mit der Ortszeit des aktuellen Benutzers.

UTCNow-, UTCToday- und IsUTCToday-Funktionen sind dieselben wie ihre Nicht-UTC-Gegenstücke, arbeiten jedoch mit zeitzonenunabhängigen Werten und verwenden die koordinierte Weltzeit (UTC).

Weitere Informationen finden Sie unter Datum, Zeit und Datum/Zeit im Datentyp Dokumentation und Arbeiten mit Daten und Uhrzeitangaben.

Veränderliche Funktionen

Funktionen Jetzt, Heute, UTCNow und UTCToday sind volatil. Diese Funktionen geben für jede Auswertung einen anderen Wert zurück.

Wird eine veränderliche Funktion in einer Datenflussformel verwendet, gibt sie nur dann einen anderen Wert zurück, wenn die Formel, in der sie vorkommt, erneut ausgewertet wird. Wenn nichts in der Formel geändert wird, bleibt der Wert während der Ausführung der App derselbe.

Ein Bezeichnungssteuerlement mit Label1.Text = Now() ändert sich nicht, solange die App aktiv ist. Neue Werte werden nur beim Schließen und erneuten Öffnen der App generiert.

Die Funktion wird neu ausgewertet, wenn sie Teil einer Formel ist, in der sich etwas anderes geändert hat. Wenn in das Beispiel z.B. ein Schiebereglersteuerelement mit Label1.Text = DateAdd( Now(), Slider1.Value, Minutes ) aufgenommen wird, wird die aktuelle Uhrzeit jedes Mal abgerufen, wenn sich der Wert des Schiebereglersteuerelements ändert und der Eigenschaftentext der Bezeichnung neu ausgewertet wird.

Bei der Verwendung in einer Verhaltensformel werden veränderliche Funktionen immer zusammen mit der Verhaltensformel ausgewertet. Ein Beispiel finden Sie weiter unten.

Syntax

Lokale Zeitzone für den Benutzer verwenden

Now()

Today()

IsToday( DateTime )

• DateTime ‑ Erforderlich: Der zu prüfende Datum/Uhrzeit-Wert.

Koordinierte Weltzeit (UTC) verwenden

UTCNow()

UTCToday()

IstUTCToday( TimeZoneIndependentTime )

• TimeZoneIndependentDateTime - Erforderlich. Der zu testende zeitzonenunabhängige Datums-/Uhrzeitwert.

Beispiele

Für die Beispiele in diesem Abschnitt ist die aktuelle Uhrzeit 20:58 Uhr am 11. Juli 2021 in der pazifischen Zeitzone (UTC-8) und die Sprache ist de-de.

Anzeigen einer Uhr, die sich in Echtzeit aktualisiert

1. Fügen Sie ein Timer-Steuerelement hinzu, und legen Sie dessen Eigenschaft Duration auf 1000 und die Eigenschaft Repeat auf TRUE fest.

   Der Timer wird eine Sekunde lang ausgeführt, beginnt automatisch von Neuem und setzt dieses Muster fort.

2. Legen Sie die Eigenschaft OnTimerEnd des Steuerelements auf diese Formel fest:

   Set( CurrentTime, Now() )

   Jedes Mal, wenn der Timer (nach einer Sekunde) neu startet, legt diese Formel die globale Variable CurrentTime auf den aktuellen Wert der Now-Funktion fest.

   

3. Fügen Sie ein Label-Steuerelement hinzu, und legen Sie dessen Text-Eigenschaft auf diese Formel fest:

   Text( CurrentTime, LongTime24 )

   Formatieren Sie das Datum und die Uhrzeit mithilfe der Text-Funktion nach Bedarf, oder legen Sie diese Eigenschaft einfach auf CurrentTime fest. Es werden dann nur noch Minuten und keine Sekunden mehr angezeigt.

   

4. Zeigen Sie eine Vorschau der App an, indem Sie F5 drücken. Klicken oder tippen Sie anschließend auf den Timer, um ihn zu starten.

   Die Bezeichnung zeigt immer sekundengenau die aktuelle Uhrzeit an.

   

5. Legen Sie die Timer-Eigenschaften AutoStart und Visible auf TRUE bzw. FALSE fest.

   Der Timer ist nicht sichtbar und startet automatisch.

6. Legen Sie die OnStart-Eigenschaft des Bildschirms fest, damit die Variable CurrentTime wie in diesem Beispiel über einen gültigen Wert verfügt:

   Set(CurrentTime, Now())

   Sobald die App gestartet wird (bevor der Timer eine ganze Sekunde lang ausgeführt wird), wird die Bezeichnung angezeigt.