Narzędzia formatujące

Funkcje do formatowania dat, godzin i liczb do wyświetlania.

import {
  formatDate,
  formatDateTime,
  formatTimeDisplay,
  padNumber,
} from "react-date-range-picker-headless";

formatDate

Formatuje datę za pomocą dostosowywalnego ciągu formatującego.


Sygnatura	`formatDate(date: Date, format?: string): string`
Domyślny format	`"YYYY.MM.DD"`

formatDate(new Date(2026, 2, 1)); // "2026.03.01"
formatDate(new Date(2026, 2, 1), "YYYY-MM-DD"); // "2026-03-01"
formatDate(new Date(2026, 2, 1), "M/D"); // "3/1"

formatDateTime

Formatuje datę z czasem za pomocą dostosowywalnego ciągu formatującego.


Sygnatura	`formatDateTime(date: Date, format?: string): string`
Domyślny format	`"YYYY.MM.DD HH:mm"`

formatDateTime(new Date(2026, 2, 1, 14, 30)); // "2026.03.01 14:30"
formatDateTime(new Date(2026, 2, 1, 14, 30), "YYYY-MM-DD HH:mm:ss"); // "2026-03-01 14:30:00"

formatTimeDisplay

Formatuje ciąg znaków wyświetlania czasu na podstawie rozpoznanego TimeConfig.


Sygnatura	`formatTimeDisplay(hour: number, minute: number, second: number, period: TimePeriod, config: Required<TimeConfig>, amLabel?: string, pmLabel?: string): string`

Parametr	Typ	Domyślnie	Opis
`hour`	`number`	—	Wartość godziny (wewnętrznie format 24-godzinny).
`minute`	`number`	—	Wartość minuty.
`second`	`number`	—	Wartość sekundy.
`period`	`TimePeriod`	—	AM/PM (używane do wyświetlania w trybie 12-godzinnym).
`config`	`Required<TimeConfig>`	—	Rozpoznana konfiguracja czasu.
`amLabel`	`string`	`"AM"`	Etykieta wyświetlania AM.
`pmLabel`	`string`	`"PM"`	Etykieta wyświetlania PM.

import { resolveTimeConfig, formatTimeDisplay } from "react-date-range-picker-headless";

const config = resolveTimeConfig({ precision: "minute", hourFormat: "24" });
formatTimeDisplay(14, 30, 0, "PM", config); // "14:30"

const config12 = resolveTimeConfig({ precision: "second", hourFormat: "12" });
formatTimeDisplay(14, 30, 15, "PM", config12); // "02:30:15 PM"

padNumber

Uzupełnia liczbę do 2-cyfrowego ciągu znaków.


Sygnatura	`padNumber(num: number): string`

padNumber(1); // "01"
padNumber(12); // "12"
padNumber(0); // "00"