Skip to main content
Intl.DateTimeFormat - Intl - Web documentation
interface Intl.DateTimeFormat
Unstable

Methods

format(date?: Formattable | number): string

Format a date into a string according to the locale and formatting options of this Intl.DateTimeFormat object.

formatToParts(date?: Formattable | number): globalThis.Intl.DateTimeFormatPart[]

Allow locale-aware formatting of strings produced by Intl.DateTimeFormat formatters.

formatRange<T extends Formattable>(
startDate: T,
endDate: T,
): string

Format a date range in the most concise way based on the locale and options provided when instantiating this Intl.DateTimeFormat object.

formatRange(
startDate: Date | number,
endDate: Date | number,
): string
formatRangeToParts<T extends Formattable>(
startDate: T,
endDate: T,
): DateTimeFormatRangePart[]

Allow locale-aware formatting of tokens representing each part of the formatted date range produced by Intl.DateTimeFormat formatters.

formatRangeToParts(
startDate: Date | number,
endDate: Date | number,
): DateTimeFormatRangePart[]