Freigeben über

Verhalten und Format der Datum- und Zeitspalte

  • Artikel

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

Für Datums- und Uhrzeitspalten stehen zwei Optionen zur Verfügung.

  • Verhalten : Ob Werte für Zeitzonen angepasst werden sollen.
  • Format : Ob der Zeitanteil des Werts angezeigt werden soll.

Behavior

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 Verhalten-Optionen an die Zeitzone des Benutzers anpassen.

  • Ortszeit Benutzer: Passt Werte für die Zeitzone des Benutzers an. Dies ist die Standardeinstellung. Sie können dies einmal in ein anderes Verhalten ändern.
  • Zeitzonenunabhängig: Keine Zeitzonenkonvertierung.
  • Nur Datum: Keine Zeitzonenkonvertierung. Nicht wie Zeitzonenunabhängig, der Zeitanteil wird nicht gespeichert.

Die Zeitzone des Benutzers wird in persönliche Optionen festgelegt, 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 enthalten einen Zeitanteil, es sei denn, sein 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.

Hinweis

Benutzer können den Zeitanteil weiterhin ändern, wenn das Format gleich Nur Datum ist. Zum Beispiel mit Web-API-Aufrufen oder durch die Verwendung eines Steuerelements, das den Zeitanteil hat. Das ist anders als beim Nur Datum-Verhalten, wo der Zeitanteil überhaupt nicht gespeichert wird.

Verwendungsrichtlinien

Verwenden Sie das Verhalten Zeitzonenunabhängig, wenn keine Zeitzoneninformationen erforderlich sind, wie die Hoteleincheckzeiten. Dank dieser Auswahl sehen Benutzer in allen Zeitzonen denselben Datums- und Uhrzeitwert.

Verwenden Sie das Verhalten Nur Datum, wenn Informationen zur Uhrzeit des Tages und die Zeitzone nicht erforderlich sind, wie Geburtstage oder Jahrestage. Dank dieser Auswahl sehen Benutzer in allen Zeitzonen den exakt gleichen Datums- und Uhrzeitwert.

Zeitzonenunabhängig-Verhalten mit Nur Datum-Format ist praktisch das Gleiche wie Nur Datum-Verhalten. 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 Benutzende in einer modellgesteuerten App ein Datum einstellen, wird der Zeitanteil automatisch auf Mitternacht ihrer Zeitzone eingestellt. 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-Anforderung für den formatierten Wert:

Behavior 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:

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

Behavior 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 und verschob die Zeit um eine Stunde auf 3:00 Uhr. 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. In der pazifischen Zeitzone endete die Sommerzeit beispielsweise am 5. November 2023 um 2:00 Uhr und verschob die Zeit um eine Stunde zurück auf 1:00 Uhr. 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 mit einer Web-API-Anforderung für den Wert:

Behavior 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:

Behavior 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:

Behavior 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:

Behavior Formatieren JavaScript dateValue.toString()
Nur Datum - 15.10.2023 00:00 (Browser-Zeitzone)

Hinweis

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

Für das Verhalten Ortszeit Benutzer sollte das Client-API-Ergebnis als UTC-Wert interpretiert werden. Verwenden Sie Date.getUTCDate(), Date.getUTCHours() usw., um damit zu arbeiten. Um zu erhalten, was der Benutzer sieht, wenden Sie getTimeZoneOffsetMinutes an. Verwenden Sie nicht Date.getDate(), Date.getHours() usw., da diese den Wert in der Zeitzone des Browsers anzeigen.

Für das Verhalten Zeitzonenunabhängig und Nur Datum sollte das Client-API-Ergebnis als Wert in der Browser-Zeitzone interpretiert werden. Verwenden Sie Date.getDate(), Date.getHours() usw., um damit zu arbeiten. Verwenden Sie nicht Date.getUTCDate(), Date.getUTCHours() usw., da Sie sich nicht an Zeitzonen anpassen müssen.

Ortszeit Benutzerverhalten ändern

Sie können das Verhalten von vorhandenen benutzerdefinierten Datumsspalten von Ortszeit Benutzer in Nur Datum oder Zeitzonenunabhängig ändern, es sei denn, der Herausgeber einer verwalteten Lösung verhindert dies. 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

Bevor Sie das Verhalten einer Datums- und Zeitspalte ändern, sollten Sie alle Abhängigkeiten der Spalte wie Geschäftsregeln, Workflows und berechnete oder Rollupfelder überprüfen, um sicherzustellen, dass als Ergebnis der Änderung des Verhaltens keine Probleme auftreten. 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, die eine Datumsspalte enthält, mithilfe des Verhaltens Ortszeit Benutzer importieren, können Sie das Verhalten in Nur Datum oder Zeitzonenunabhängig ändern.

Hinweis

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
Erstellen und Bearbeiten von Spalten
Definition berechneter Spalten für das Automatisieren von manuellen Berechnungen
Verwaltete Spalteneigenschaften
Verwaltete Eigenschaften
Blog: Arbeiten mit Zeitzonen in Dataverse
Verhalten und Format der Spalte für Datum und Uhrzeit mithilfe von Code konfigurieren

Hinweis

Können Sie uns Ihre Präferenzen für die Dokumentationssprache mitteilen? Nehmen Sie an einer kurzen Umfrage teil. (Beachten Sie, dass diese Umfrage auf Englisch ist.)

Die Umfrage dauert etwa sieben Minuten. Es werden keine personenbezogenen Daten erhoben. (Datenschutzbestimmungen).