formatDate / timestampToTime

Formatiert ein Datum mit einem Muster aus Token.

API

formatDate(value?, pattern?)

Parameter	Beschreibung	Typ	Standard
`value`	Zeitstempel, Datumszeichenkette oder `Date`; weglassen für jetzt	`number \| string \| Date`	jetzt
`pattern`	Muster aus Token	`string`	`'YYYY-MM-DD HH:mm:ss'`

Token	Bedeutung	Token	Bedeutung
`YYYY`/`YY`	Jahr	`mm`/`m`	Minute
`MM`/`M`	Monat (1–12)	`ss`/`s`	Sekunde
`DD`/`D`	Tag	`SSS`	Millisekunden
`HH`/`H`	Stunde (0–23)	`A`/`a`	AM/PM · am/pm
`hh`/`h`	Stunde (1–12)	`[...]`	Wörtlicher Text

Gibt 'Invalid Date' zurück, wenn sich die Eingabe nicht deuten lässt.

timestampToTime(timestamp?)

Veraltet. Gibt ein Date zurück, dem eine format-Methode an die Instanz gehängt wurde.

Beispiel

import { formatDate } from 'ranuts';

formatDate(); // '2026-07-25 14:30:00'
formatDate(1753425000000, 'YYYY/MM/DD'); // '2026/07/25'
formatDate(new Date(), 'YYYY[年]MM[月]DD[日] hh:mm a');
formatDate('not a date'); // 'Invalid Date'

Hinweise

Groß- und Kleinschreibung zählt. MM ist der Monat, mm die Minute; HH zählt bis 24, hh bis 12.
Das Muster wird in einem Durchgang ersetzt, ein gerade geschriebener Wert kann also von einem späteren Token nie noch einmal erwischt werden.
Setze wörtlichen Text in [], damit seine Buchstaben von der Ersetzung verschont bleiben.