Funktionen „Now“, „Today“, „IsToday“, „UTCNow“ und „UTCToday“, „IsUTCToday“
Gilt für:
Canvas-Apps Desktop-Flows Dataverse Formelspalten Modellgesteuerte Apps Power Pages Power Platform CLI
Gibt das aktuelle Datum und die Uhrzeit zurück und prüft, ob ein Datum/Uhrzeit-Wert heute ist.
Anmerkung
PAC CLI-Befehle „pac power-fx“ unterstützen die Funktionen UTCNow, UTCToday und IsUTCToday nicht.
Beschreibung
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. „Heute“ hat den ganzen Tag über den gleichen Wert, von heute Mitternacht bis morgen Mitternacht.
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).
Die Funktionen „Jetzt“, „ Heute“ und „IstHeute “ arbeiten mit der Ortszeit des aktuellen Benutzers.
Die Funktionen UTCNow, UTCToday und IsUTCToday sind dieselben wie ihre Nicht-UTC-Gegenstücke, arbeiten jedoch mit zeitzonenunabhängigen Werten und verwenden die koordinierte Weltzeit (UTC).
Notiz
- UTCNow, UTCToday und IsUTCToday sind nur in Microsoft Dataverse for Teams Formelspalten und nur für zeitunabhängige Felder und Werte verfügbar.
- Jetzt, Heute und IstHeute sind in Dataverse for Teams Formelspalten nicht verfügbar, da Auswertungen ohne Kenntnis der lokalen Zeitzone des aktuellen Benutzers Fertig sind.
Mehr Informationen: Arbeiten Sie mit Formeltabellenspalten in Dataverse for Teams
Weitere Informationen finden Sie unter Datum, Zeit und Datum/Zeit im Datentyp Dokumentation und Arbeiten mit Daten und Uhrzeitangaben.
Veränderliche Funktionen
Jetzt, Heute, UTCJetzt und UTCHeute sind volatile Funktionen. 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
Jetzt()
Heute()
IstHeute( Datum/Uhrzeit )
- DateTime – Erforderlich. Der zu prüfende Datum/Uhrzeit-Wert.
Koordinierte Weltzeit (UTC) verwenden
UTCJetzt()
UTCHeute()
IstUTCHeute( ZeitzonenunabhängigeZeit )
- 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.
| Formel | Beschreibung | Ergebnis |
|---|---|---|
| Text (Jetzt (), "mm/dd/yyyy hh:mm:ss") | Ruft das aktuelle Datum und die Uhrzeit in der Zeitzone des Benutzers ab und zeigt sie als Zeichenfolge an. | 11.07.2021, 20.58.00 |
| Text(Heute(), "mm/tt/jjjj hh:mm:ss" ) | Ruft nur das aktuelle Datum ab, sodass der Zeitanteil auf Mitternacht festgelegt bleibt, und zeigt dieses als Zeichenfolge an. | 12.07.2021, 00.00.00 |
| IstHeute(Jetzt()) | Prüft, ob das aktuelle Datum und die Uhrzeit zwischen Mitternacht heute und Mitternacht morgen liegen. | WAHR |
| IstHeute(Heute()) | Prüft, ob das aktuelle Datum zwischen Mitternacht heute und Mitternacht morgen liegt | WAHR |
| Text( DateAdd( Jetzt(), 12 ), "mm/tt/jjjj hh:mm:ss" ) | Ruft das aktuelle Datum und die Uhrzeit ab, fügt dem aktuellen Datum 12 Tage hinzu und zeigt es als Zeichenfolge an. | 23.07.2021, 20.58.00 |
| Text( DateAdd( Heute(), 12 ), "mm/tt/jjjj hh:mm:ss" ) | Ruft das aktuelle Datum ab, das Ergebnis 12 Tage hinzugefügt, und zeigt ihn als Zeichenfolge | 23.07.2021, 00.00.00 |
| IstHeute( DateAdd( Jetzt(), 12 ) ) | Prüft, ob das aktuelle Datum und die Uhrzeit plus 12 Tage zwischen Mitternacht heute und Mitternacht morgen liegen. | FALSCH |
| IstHeute( DateAdd( Heute(), 12 ) ) | Prüft, ob das aktuelle Datum plus 12 Tage zwischen Mitternacht heute und Mitternacht morgen liegt | FALSCH |
| Stunde (UTCNow()) | Ruft das aktuelle Datum und die Uhrzeit in UTC ab und extrahiert nur die Stunde, die 8 Stunden vor der Ortszeit liegt. | 4 |
| Tag (UTCToday()) | Ruft das aktuelle Datum nur in UTC ab und extrahiert den Tag, der 1 Tag vor der Ortszeit liegt. | 12 |
| IstUTCHeute( UTCNow() ) | Prüft, ob das aktuelle Datum und die Uhrzeit zwischen Mitternacht heute und Mitternacht morgen liegen, alles in UTC-Zeit. | WAHR |
| IstUTCHeute( UTCHeute() ) | Prüft, ob das aktuelle Datum und die Uhrzeit zwischen Mitternacht heute und Mitternacht morgen liegen, alles in UTC-Zeit. | WAHR |
Anzeigen einer Uhr, die sich in Echtzeit aktualisiert
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.
Legen Sie die Eigenschaft OnTimerEnd des Steuerelements auf diese Formel fest:
Setze(aktuelleZeit, Jetzt())
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.
Fügen Sie ein Label-Steuerelement hinzu, und legen Sie dessen Text-Eigenschaft auf diese Formel fest:
Text( aktuelleZeit, LangeZeit24 )
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.
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.
Legen Sie die Timer-Eigenschaften AutoStart und Visible auf TRUE bzw. FALSE fest.
Der Timer ist nicht sichtbar und startet automatisch.
Legen Sie die OnStart-Eigenschaft des Bildschirms fest, damit die Variable CurrentTime wie in diesem Beispiel über einen gültigen Wert verfügt:
Setze(aktuelleZeit, Jetzt())
Sobald die App gestartet wird (bevor der Timer eine ganze Sekunde lang ausgeführt wird), wird die Bezeichnung angezeigt.