Verhalten und Format der Datum- und Zeitspalte

In Microsoft Dataverse können Sie einrichten, wie Datums‑ und Uhrzeitwerte Benutzern angezeigt werden und wie sie an Zeitzonen angepasst werden.

Zusätzlich zu den standardeigenschaften, die mit den meisten Spalten verfügbar sind, weisen Datums- und Uhrzeitspalten zwei zusätzliche Eigenschaften auf:

  • Anpassung der Zeitzone: Gibt an, ob Werte für Zeitzonen angepasst werden sollen.
  • Format : Ob der Zeitanteil des Werts angezeigt werden soll.

Zeitzonenanpassung

Dataverse speichert alle Datums‑ und Uhrzeitwerte in der UTC-Zeitzone. Wenn Ihre App Werte anzeigt oder von Benutzern eingegebene Werte verarbeitet, können Dataverse und modellgesteuerte Apps sich mit diesen Verhaltensoptionen an die Zeitzone des Benutzers anpassen.

  • Ortszeit Benutzer: Passt Werte für die Zeitzone des Benutzers an. Dies sind die standardmäßig benutzerdefinierten Datums- und Zeitformate. Sie können dies einmal in ein anderes Verhalten ändern.
  • Zeitzonenunabhängig: Keine Zeitzonenkonvertierung. Dies ist das standardmäßig benutzerdefinierte Datumsformat.

Legen Sie die Zeitzone des Benutzers in persönlichen Optionen fest, nicht die Systemzeitzone in Windows, Android, iOS oder macOS. Allerdings kann sich die Systemzeitzone auf Client-Skripte auswirken, die mit JavaScript-Datumsangaben arbeiten.

Formatieren

Alle Datums- und Uhrzeitspalten weisen einen Zeitteil auf, es sei denn, ihr Verhalten ist "Nur Datum". Format: Bestimmt, ob der Zeitanteil des Werts angezeigt werden soll.

  • Datum und Uhrzeit: Zeigt das Datum und die Uhrzeit des Werts an.
  • Nur Datum: Zeigt nur den Datumsteil des Werts an.

Notiz

Benutzer können den Zeitanteil weiterhin ändern, wenn das Format gleich Nur Datum ist. Beispielsweise mithilfe von Web-API-Aufrufen oder mithilfe eines Steuerelements, das den Zeitteil aufweist. Dieses Verhalten unterscheidet sich vom "Nur-Datumsverhalten", bei dem der Zeitteil überhaupt nicht gespeichert ist.

Verwendungsrichtlinien

Verwenden Sie die Zeitzone unabhängig , wenn keine Zeitzoneninformationen erforderlich sind, z. B. Hotel-Check-In-Zeiten. Dank dieser Auswahl sehen Benutzer in allen Zeitzonen denselben Datums- und Uhrzeitwert.

Verwenden Sie Datum nur , wenn Informationen über die Uhrzeit des Tages und die Zeitzone nicht erforderlich sind, z. B. Geburtstage oder Jahrestage. Dank dieser Auswahl sehen Benutzer in allen Zeitzonen den exakt gleichen Datums- und Uhrzeitwert.

Zeitzonenunabhängig mit nur Datum entspricht weitgehend dem Festlegen der Spalte als nur Datum. Verwenden Sie Ersteres, wenn Sie nicht sicher sind, ob Sie den Zeitanteil in Zukunft benötigen.

Wichtig

Vermeiden Sie das Format Nur Datum mit dem Verhalten Lokaler Benutzender. Benutzenden in anderen Zeitzonen wird möglicherweise ein anderes Datum angezeigt, was in den meisten Fällen nicht beabsichtigt ist. Wenn ein Benutzer ein Datum in einer modellgesteuerten App festlegt, wird der Zeitbereich automatisch auf Mitternacht seiner Zeitzone festgelegt. Dies kann dazu führen, dass das Datum für andere Benutzenden als einen Tag früher oder später angezeigt wird.

Beispiele

Anzeigewerte

Dataverse speichert 2023-10-15T07:30:00Z (oder 2023-10-15 für das Verhalten Nur Datum). Benutzer in der Zeitzone UTC-8 sehen diese in der modellgesteuerten App oder mit einer Web-API-Anfrage für den formatierten Wert:

Verhalten Formatieren Anzeigewert
Ortszeit Benutzer Datum und Uhrzeit 14. Oktober 2023, 23:30 Uhr
Ortszeit Benutzer Nur Datum 14. Oktober 2023
Zeitzonenunabhängig Datum und Uhrzeit 15. Oktober 2023, 7:30 Uhr
Zeitzonenunabhängig Nur Datum 15. Oktober 2023
Nur Datum - 15. Oktober 2023

Geben Sie Werte in eine App ein

Benutzer in der Zeitzone UTC-8 geben October 14th, 2023, 11:30 pm in eine modellgesteuerte App ein. Der Wert wird in Dataverse gespeichert als:

Verhalten Formatieren Gespeicherter Wert in Dataverse
Ortszeit Benutzer Datum und Uhrzeit 2023-10-15T07:30:00Z
Ortszeit Benutzer Nur Datum 2023-10-15T07:30:00Z
Zeitzonenunabhängig Datum und Uhrzeit 2023-10-14T23:30:00Z
Zeitzonenunabhängig Nur Datum 2023-10-14T23:30:00Z
Nur Datum - 2023-10-14

Wenn der Benutzer nur das Datum October 14th, 2023 eingibt, wird als Zeitanteil 00:00 Uhr angenommen.

Verhalten Formatieren Gespeicherter Wert in Dataverse
Ortszeit Benutzer Nur Datum 2023-10-14T08:00:00Z
Zeitzonenunabhängig Nur Datum 2023-10-14T00:00:00Z
Nur Datum - 2023-10-14

Ungültige Werte in eine App eingeben

Verschiedene Clients haben unterschiedliche Möglichkeiten, mit ungültigen Eingaben umzugehen. In der Pazifischen Zeitzone begann die Sommerzeit beispielsweise am 12. März 2023 um 2:00 Uhr, wobei die Zeit um eine Stunde auf 3:00 Uhr verschoben wird. Die Zeit zwischen 2:00 und 3:00 Uhr an diesem Tag existiert nicht. Wenn Benutzer versuchen, einen Wert in diesem Zeitraum einzugeben, führen Apps möglicherweise Folgendes aus:

  • Zur vorherigen oder nächsten gültigen Uhrzeit wechseln.
  • Zum letzten bekannten Wert zurückkehren.
  • Eine Fehlermeldung anzeigen.
  • In der Zeitauswahl keine Zeiten zwischen 2:00 und 3:00 Uhr anzeigen, damit Benutzer sie gar nicht erst auswählen können.

Ebenso haben verschiedene Clients unterschiedliche Möglichkeiten, mit wiederholten Zeitbereichen umzugehen. Beispielsweise endete die Sommerzeit in der Pazifischen Zeitzone am 5. November 2023 um 2:00 Uhr und bewegte sich die Zeit um 1:00 Uhr rückwärts. Die Zeit zwischen 1:00 und 2:00 Uhr an diesem Tag wird zweimal wiederholt. Eine Zeit wie 1:30 Uhr könnte sich auf beide Zeitzonen beziehen. Wenn Sie Zeiten in diesem Bereich eindeutig anzeigen oder eingeben müssen, wechseln Sie am besten vorübergehend zu einer Zeitzone, in der die Sommerzeit nicht gilt.

Erhalten Sie Rohwerte mit der Web-API

Dataverse speichert 2023-10-15T07:30:00Z (oder 2023-10-15 für das Verhalten Nur Datum). Benutzer in allen Zeitzonen erhalten diese Werte mit einer Web-API-Anforderung für den Wert:

Verhalten Formatieren Rohwert
Ortszeit Benutzer Datum und Uhrzeit 2023-10-15T07:30:00Z
Ortszeit Benutzer Nur Datum 2023-10-15T07:30:00Z
Zeitzonenunabhängig Datum und Uhrzeit 2023-10-15T07:30:00Z
Zeitzonenunabhängig Nur Datum 2023-10-15T07:30:00Z
Nur Datum - 2023-10-15

Werte mit der Client-API abrufen

Benutzer in der Zeitzone UTC-8 geben October 14th, 2023, 11:30 pm in eine modellgesteuerte App ein. Client-API-Funktionen wie formContext.getAttribute(<column name>).getValue() geben den Wert mit angewendeten Zeitzonenanpassungen zurück:

Verhalten Formatieren Javascript dateValue.toUTCString()
Ortszeit Benutzer Datum und Uhrzeit 2023-10-15 07:30 (UTC)
Ortszeit Benutzer Nur Datum 2023-10-15 07:30 (UTC)

Für zeitzonenunabhängiges Verhalten liegt der JavaScript-Datumswert in der Zeitzone des Browsers:

Verhalten Formatieren Javascript dateValue.toString()
Zeitzonenunabhängig Datum und Uhrzeit 14.10.2023 23:30 (Browser-Zeitzone)
Zeitzonenunabhängig Nur Datum 14.10.2023 23:30 (Browser-Zeitzone)

JavaScript-Datumswerte haben immer eine Zeitkomponente. Aus diesem Grund hat das Nur Datum-Verhalten eine Zeitkomponente von 00:00 Uhr:

Verhalten Formatieren Javascript dateValue.toString()
Nur Datum - 15.10.2023 00:00 (Browser-Zeitzone)

Notiz

JavaScript-Datumswerte werden von der Zeitzone des Browsers beeinflusst, die sich aus den Betriebssystemeinstellungen des Geräts ergibt.

Interpretieren Sie für das lokale Verhalten des Benutzers das Client-API-Ergebnis als UTC-Wert. Verwenden Sie Date.getUTCDate() oder Date.getUTCHours(), um damit zu arbeiten. Um zu erhalten, was der Benutzer sieht, wenden Sie getTimeZoneOffsetMinutes an. Verwenden Sie weder Date.getDate() noch Date.getHours(), da diese Funktionen den Wert in der Zeitzone des Browsers anzeigen.

Interpretieren Sie das Client-API-Ergebnis für das unabhängige Zeitzonenverhalten und das Datum nur als Wert in der Zeitzone des Browsers. Verwenden Sie Date.getDate() oder Date.getHours(), um damit zu arbeiten. Verwenden Sie Date.getUTCDate() oder Date.getUTCHours() nicht, da Sie sich nicht an Zeitzonen anpassen müssen.

Ortszeit Benutzerverhalten ändern

Sofern der Herausgeber einer verwalteten Lösung das lokale Verhalten nicht verhindert, können Sie das Verhalten vorhandener benutzerdefinierter Datumsspalten von Benutzer lokal auf nur Datum oder zeitzonenunabhängig ändern. Dies ist eine einmalige Änderung.

Das Ändern des Spaltenverhaltens wirkt sich auf die Spaltenwerte aus, die hinzugefügt oder geändert werden, nachdem das Spaltenverhalten geändert wurde. Die vorhandenen Spaltenwerte des Felds bleiben in der Datenbank im UTC-Zeitzonenformat. Um das Verhalten der vorhandenen Spaltenwerte von UTC in Nur Datum zu ändern, benötigen Sie möglicherweise die Hilfe eines Entwicklers, um das Verhalten der vorhandenen Datums- und Zeitwerte in der Datenbank zu konvertieren.

Warnung

Überprüfen Sie vor dem Ändern des Verhaltens einer vorhandenen Datums- und Uhrzeitspalte alle Abhängigkeiten der Spalte, z. B. Geschäftsregeln, Workflows, berechnete Spalten oder Rollupspalten, um sicherzustellen, dass keine Probleme auftreten, da das Verhalten geändert wird. Nach der Änderung des Verhaltens einer Datums- und Uhrzeitspalte öffnen Sie alle Geschäftsregeln, Workflows, berechneten Spalten und Rollupspalten, die von der geänderten Spalte abhängig sind, überprüfen und speichern die Informationen, um sicherzustellen, dass das aktuelle Verhalten einer Datums- und Uhrzeitspalte und der aktuelle Wert verwendet werden.

Änderungsverhalten während eines Imports

Wenn Sie eine Lösung importieren, die eine Datumsspalte mit Benutzerlokal enthält, können Sie das Verhalten in nur 'Datum' oder Zeitzonenunabhängig ändern.

Notiz

Sie können das Verhalten einer vorhandenen verwalteten Spalte Nur Datum oder Datum und Uhrzeit nur ändern, wenn Sie der Herausgeber sind. Um eine Änderung an diesen Feldern vorzunehmen, muss ein Upgrade der Lösung durchgeführt werden, das die Spalte Nur Datum oder Datum und Uhrzeit hinzugefügt hat. Weitere Informationen: Upgrade oder Update einer Lösung

Verhindert das Ändern des Verhaltens

Wenn Sie eine benutzerdefinierte Datumsspalte in einer verwalteten Lösung verteilen, verhindern Sie, dass Personen mithilfe Ihrer Lösung das Verhaltens ändern, indem Sie die Einstellung CanChangeDateTimeBehavior auf False festlegen. Weitere Informationen: Verwaltete Eigenschaften für Spalten festlegen

Datums- und Uhrzeitabfrageoperatoren für „Nur Datum“-Verhalten werden nicht unterstützt

Die folgenden datums- und uhrzeitbezogenen Abfrageoperatoren sind ungültig für das Verhalten Nur Datum. Ein Ungültiger Operator-Ausnahmefehler wird ausgelöst, wenn einer dieser Operatoren in der Abfrage verwendet wird.

  • Älter als x Minuten
  • Älter als x Stunden
  • Letzte X Stunden
  • Nächste X Stunden

Siehe auch

Probleme mit Datum und Uhrzeit in modellgesteuerten Apps beheben
Spalten erstellen und bearbeiten
Berechnete Spalten für das Automatisieren von manuellen Berechnungen definieren
Verwaltete Spalteneigenschaften
Verwaltete Eigenschaften
Blog: Arbeiten mit Zeitzonen in Dataverse
Verhalten und Format der Spalte für Datum und Uhrzeit mithilfe von Code konfigurieren

  • Last updated on