Datums- und Zeitformatierung

Einstellungen für die Formatierung des Datums und der Uhrzeit.

Einige Steuerelemente können Datums- und Zeitwerte anzeigen oder Datums- und Zeitwerte entgegennehmen. Als Quelle wird eine Prozessvariable vom Datentyp VT_DATE (für Steuerelemente DateTimeVarIn und DateTimeVarOut) oder die Systemzeit (für Steuerelement Clock) verwendet. Das Datum und die Uhrzeit werden automatisch in dem für die Sprache der App bzw. des Browsers gültigen Format angezeigt.

Sprachunabhängige Einstellungen, etwa die Positionierung der Datums- und Zeitanzeige, können für ein Steuerelement über die Eigenschaften der Kategorie "DateTimeFormat" festgelegt werden.

DateTimeMode

Legt fest, ob nur die Zeit, nur das Datum oder beides angezeigt wird und wie diese Elemente innerhalb des Steuerelements positioniert werden.

• Das Zeitformat wird über die Eigenschaft "FormatTime" und das Datumsformat über die Eigenschaft "FormatDate" festgelegt.

• Bei den Steuerelementen Clock und DateTimeVarOut kann die horizontale und die vertikale Ausrichtung der Datums- und der Zeitanzeige über die Eigenschaften "AlignItems" und "JustifyContent" festgelegt werden.

• TimeOnly

  Zeigt nur die Zeit an.

• DateOnly

  Zeigt nur das Datum an.

• TimeDate

  Zeigt sowohl das Datum als auch die Zeit an. Die beiden Elemente werden in einer Zeile positioniert, die Zeit links und dann das Datum rechts.

• DateTime

  Zeigt sowohl das Datum als auch die Zeit an. Die beiden Elemente werden in einer Zeile positioniert, das Datum links und die Zeit rechts.

• TimeCRDate

  Zeigt sowohl das Datum als auch die Zeit an. Die beiden Elemente werden in einer Spalte positioniert, die Zeit wird dabei über dem Datum positioniert.

• DateCRTime

  Zeigt sowohl das Datum als auch die Zeit an. Die beiden Elemente werden in einer Spalte positioniert, das Datum wird dabei über der Zeit positioniert.

FormatDate

Legt das Datumsformat fest (siehe auch Automatische Umschaltung der Datums- und Zeitformate je nach Spracheinstellung weiter unten).

• LongDate

  Datum mit ausgeschriebenem Monat.

  Beispiel:

  de-DE	en-US
  06. Februar 2023	February 06, 2023

• NamedLongDate

  Datum mit Wochentag und ausgeschriebenem Monat.

  Beispiel:

  de-DE	en-US
  Montag, 06. Februar2023	Monday, December 06, 2023

• ShortDate

  Datum in Zahlen.

  Beispiel:

  de-DE	en-US
  06.02.2023	02/06/2023

FormatTime

Legt das Zeitformat fest (siehe auch Automatische Umschaltung der Datums- und Zeitformate je nach Spracheinstellung weiter unten).

• LongTime

  Angabe von Stunden, Minuten und Sekunden.

  Beispiel:

  de-DE	en-US
  16:03:45	04:03:45 PM

• ShortTime

  Angabe von Stunden und Minuten.

  Beispiel:

  de-DE	en-US
  16:03	04:03 PM

Automatische Umschaltung der Datums- und Zeitformate je nach Spracheinstellung

In unterschiedlichen Sprachen und Regionen gelten verschiedene Regeln zur Angabe des Datums und der Uhrzeit, allgemein als Datums- und Zeitformate bezeichnet.

Beispiel: Ein und derselbe Kalendertag wird in Deutschland als "06. Februar 2023" angegeben, in den USA als "February 06, 2023".

Zur Laufzeit wird dieses sprachabhängige Datums- und Zeitformat für die Ausgabesteuerelemente "DateTimeVarOut" und "Clock" durch die Spracheinstellung der App bestimmt. Initial wird die Sprache durch den Wert von "RuntimeLanguage" in der Datei appsettings.services.json gesetzt. Die Datei ist zu finden unter [Client-Verzeichnis]Wappsettings. Die Standardeinstellung für die Laufzeitsprache ist Deutsch (de-DE).

Ausschnitt aus "appsettings.services.json"

In der laufenden App kann der Bediener eine andere Sprache auswählen. Der Applikationsrahmen z. B. enthält eine Page "Settings", auf der die bevorzugte Sprache (Deutsch oder Englisch) ausgewählt werden kann. Durch die Umstellung der App-Sprache wird das Format in allen Steuerelementen vom Typ "Clock" und "DateTimeVarOut" auf das in der jeweiligen Sprache gebräuchliche Format automatisch umgestellt.

Beim Eingabesteuerelement "DateTimeVarIn" ist das sprachabhängige Format hingegen nicht von der Spracheinstellung der App, sondern von der Spracheinstellung des Browsers abhängig.

Betrifft diese Steuerelemente:

Clock, DateTimeVarIn, DateTimeVarOut