Components

DateTime

API-Referenz für die <DateTime>-Komponente

Übersicht

Die Komponente <DateTime> gibt einen formatierten Datums- oder Zeitstring aus und unterstützt Anpassungen wie options und locale. Datum bzw. Uhrzeit werden gemäß der aktuellen locale und allen optional übergebenen Parametern formatiert.

<DateTime>{1738010355}</DateTime>
// Ausgabe: 27.1.2025

Sämtliche Formatierung erfolgt lokal mithilfe der Bibliothek Intl.DateTimeFormat.

Referenzen

Props

Prop

Type

Beschreibung

Prop-NameBeschreibung
childrenDer Inhalt, der innerhalb der Komponente gerendert wird. Typischerweise ein Datums- oder Zeitwert. Falls angegeben, hat er Vorrang vor dem value-Prop.
valueDer Standardwert für Datum oder Zeit. Kann ein String, eine Zahl (Zeitstempel) oder ein Date-Objekt sein.
optionsOptionale Formatierungsoptionen für Datum oder Zeit gemäß der Intl.DateTimeFormatOptions-Spezifikation. Verwenden Sie sie, um Stile wie Wochentagsnamen, Zeitzonen und mehr festzulegen.
localesOptionale locales zur Angabe des locale für die Formatierung. Wenn nicht angegeben, wird das locale des Benutzers verwendet. Weitere Informationen zur Angabe von locales finden Sie hier.

Rückgabewert

JSX.Element, der das formatierte Datum oder die formatierte Uhrzeit als Zeichenfolge enthält.


Beispiele

Grundlegende Verwendung

Die Komponente <DateTime> kann zur Anzeige lokalisierter Datums- oder Zeitwerte verwendet werden.

EventDate.jsx
import { DateTime } from 'gt-next';

export default function EventDate(event) {
    return (
        <DateTime> {event.date} </DateTime>. 
    );
}

Festlegen von locales

Die <DateTime>-Komponente kann verwendet werden, um Datums- oder Zeitwerte in einer bestimmten locale anzuzeigen.

EventDate.jsx

import { DateTime } from 'gt-next';

export default function EventDate(event) {
    return (
        <DateTime locales={['fr-FR']}> {event.date} </DateTime>. 
    );
}

Übersetzen von <DateTime>

Angenommen, Sie möchten, dass das Datum bzw. die Uhrzeit in einem Satz angezeigt wird, der ebenfalls übersetzt wird. Sie können die Komponente <DateTime> in eine <T>-Komponente einschließen.

EventDate.jsx
import { T, DateTime } from 'gt-next';

export default function EventDate(event) {
    return (
        <T id="eventDate">
            Die Veranstaltung findet am <DateTime> {event.date} </DateTime> statt. // [!code highlight]
        </T>
    );
}

Benutzerdefiniertes Format

Die Komponente <DateTime> unterstützt benutzerdefinierte options.

EventDate.jsx
import { DateTime } from 'gt-next';

export default function EventDate(event) {
    return (
        <DateTime options={{
            dateStyle: 'full', 
            timeStyle: 'long', 
            timeZone: 'Australia/Sydney', 
        }}>
            {event.date}
        </DateTime>.
    );
}

Hinweise

  • Die <DateTime>-Komponente ist eine Variablenkomponente, die zum Formatieren von Datums- und Uhrzeitwerten verwendet werden kann.
  • Die Komponente nutzt die Bibliothek Intl.DateTimeFormat für die Formatierung.

Nächste Schritte

  • Weitere Details und Anwendungsbeispiele zur Komponente <DateTime> sowie zu anderen Variablenkomponenten wie <Currency>, <Num> und <Var>,

Wie ist diese Anleitung?