Zum Inhalt springen
Dokumentation

Komponenten

Uhrzeit (TimePicker)

Stabil

Eine Uhrzeit tippen oder aus Vorschlägen wählen – im 24-Stunden-Format.

Der TimePicker erfasst eine Uhrzeit als HH:mm. Du kannst sie direkt tippen oder aus einer Vorschlagsliste im gewünschten Takt wählen – praktisch für Schichtbeginn, Übergabezeiten und Termine.

Wann verwenden

  • Für eine Uhrzeit am selben Tag, etwa den Beginn einer Schicht oder die Übergabe.
  • Wenn feste Intervalle die Eingabe beschleunigen, zum Beispiel alle 15 oder 30 Minuten.
  • Wenn neben der Auswahl auch eine krumme Uhrzeit wie „07:43“ möglich sein soll.

Wann nicht

  • Für Datum und Uhrzeit zusammen ist DatePicker plus TimePicker passend; ein einzelnes Feld für beides gibt es nicht.
  • Für eine Dauer in Minuten oder Stunden nimm NumberInput.
  • Für einen Zeitpunkt in einer anderen Zeitzone gehört die Zone sichtbar in die Beschriftung, nicht nur in den Wert.

Schichtbeginn

value hält die Uhrzeit als string im Format HH:mm oder null. onValueChange meldet jede bestätigte Änderung. Mit einem Startwert zeigt das Feld sofort die geplante Zeit.

Beginn um 06:00 Uhr.

Beispiel und Quelltext
schichtbeginn.tsx
import * as React from "react";

import { Label, TimePicker } from "@neodin-eu/ui";

function Schichtbeginn() {
  const [zeit, setZeit] = React.useState<string | null>("06:00");

  return (
    <div className="flex w-full max-w-xs flex-col gap-2">
      <Label htmlFor="schichtbeginn">Beginn der Schicht</Label>
      <TimePicker
        id="schichtbeginn"
        value={zeit}
        ariaLabel="Beginn der Schicht"
        onValueChange={setZeit}
      />
      <p className="text-xs text-muted-foreground">
        {zeit ? `Beginn um ${zeit} Uhr.` : "Noch keine Uhrzeit gewählt."}
      </p>
    </div>
  );
}

Vorschläge im Halbstundentakt

step bestimmt den Abstand der Vorschläge in Minuten; der Standard sind 15 Minuten. Die Liste enthält damit 96 Einträge pro Tag. Eine getippte Uhrzeit außerhalb des Takts bleibt gültig.

Vorschläge im Halbstundentakt – jede Uhrzeit lässt sich auch tippen.

Beispiel und Quelltext
uebergabe.tsx
import * as React from "react";

import { Label, TimePicker } from "@neodin-eu/ui";

function Uebergabe() {
  const [zeit, setZeit] = React.useState<string | null>(null);

  return (
    <div className="flex w-full max-w-xs flex-col gap-2">
      <Label htmlFor="uebergabezeit">Übergabezeit</Label>
      <TimePicker
        id="uebergabezeit"
        value={zeit}
        step={30}
        ariaLabel="Übergabezeit"
        placeholder="HH:mm"
        onValueChange={setZeit}
      />
      <p className="text-xs text-muted-foreground">
        Vorschläge im Halbstundentakt – jede Uhrzeit lässt sich auch tippen.
      </p>
    </div>
  );
}

Barrierefreiheit

  • Das Eingabefeld hat die Rolle combobox und heißt ohne eigene Vorgabe „Uhrzeit“; über ariaLabel bekommt es einen passenden Namen.
  • Die Vorschläge bilden eine Listbox: Jede Uhrzeit ist eine Option und lässt sich mit einem Klick übernehmen. Der Komponententest prüft die Auswahl.
  • Eine getippte Uhrzeit wird mit Enter übernommen. Das ist im Komponententest abgesichert.
  • Eine unmögliche Uhrzeit wie „25:00“ setzt aria-invalid und zeigt die Meldung „Ungültige Uhrzeit“, die über aria-describedby verbunden ist.
  • Das Feld ist in hell und dunkel frei von axe-Verstößen.

Props

Props von TimePicker
PropTypStandardPflichtBeschreibung
ariaLabelstring–NeinAccessible name of the text field; defaults to the `time` catalog entry.
classNamestring–NeinAdditional classes for the wrapper element.
disabledboolean–NeinDisables the text field and suggestion list.
idstring–NeinId assigned to the text field.
namestring–NeinName submitted with the text field.
onValueChange((value: string | null) => void)–NeinCalled with the newly selected or typed time, or `null` when cleared.
placeholderstringHH:mmNeinPlaceholder of the text field; defaults to `"HH:mm"`.
stepnumber15NeinInterval of the suggested list in minutes.
valuestring | null–JaTime as `HH:mm`, or `null` when empty.

Siehe auch