DateFormatter
A wrapper around Intl.DateTimeFormat that fixes various browser bugs, and polyfills new features.
Introduction
DateFormatter is a wrapper around the native Intl.DateTimeFormat API. It exposes the same API, but works around several browser bugs and provides polyfills for newer features. These are currently:
- A simple polyfill for the
formatRangeandformatRangeToPartsmethods for older browsers. - A workaround for a bug involving the
hour12option in Chrome and and the ECMAScript spec. - A workaround for a bug involving the
hourCycleoption in Safari.
See the MDN docs for full details on how to use the API.
Interface
constructor | ||
format | ||
| Formats a date as a string according to the locale and format options passed to the constructor. | ||
formatToParts | ||
| Formats a date to an array of parts such as separators, numbers, punctuation, and more. | ||
formatRange | ||
| Formats a date range as a string. | ||
formatRangeToParts | ||
| Formats a date range as an array of parts. | ||
resolvedOptions | ||
| Returns the resolved formatting options based on the values passed to the constructor. | ||