@formatjs/intl-datetimeformat

What is @formatjs/intl-datetimeformat?

@formatjs/intl-datetimeformat is a JavaScript library that provides a robust and flexible way to format dates and times according to the Internationalization API. It extends the capabilities of the native `Intl.DateTimeFormat` object, offering additional features and customization options for developers to format dates and times in a variety of locales and styles.

What are @formatjs/intl-datetimeformat's main functionalities?

Basic Date Formatting

This feature allows you to format dates according to a specified locale. In this example, the date is formatted in the 'en-US' locale.

const { DateTimeFormat } = require('@formatjs/intl-datetimeformat');
const dtf = new DateTimeFormat('en-US');
console.log(dtf.format(new Date()));

Custom Date Formatting

This feature allows you to customize the date format by specifying options such as year, month, and day. In this example, the date is formatted to show the full month name, numeric day, and numeric year.

const { DateTimeFormat } = require('@formatjs/intl-datetimeformat');
const dtf = new DateTimeFormat('en-US', { year: 'numeric', month: 'long', day: 'numeric' });
console.log(dtf.format(new Date()));

Time Formatting

This feature allows you to format time according to a specified locale and options. In this example, the time is formatted to show hours, minutes, and seconds.

const { DateTimeFormat } = require('@formatjs/intl-datetimeformat');
const dtf = new DateTimeFormat('en-US', { hour: 'numeric', minute: 'numeric', second: 'numeric' });
console.log(dtf.format(new Date()));

Locale-Sensitive Date and Time Formatting

This feature allows you to format both date and time in a locale-sensitive manner. In this example, the date and time are formatted according to the 'fr-FR' locale.

const { DateTimeFormat } = require('@formatjs/intl-datetimeformat');
const dtf = new DateTimeFormat('fr-FR', { year: 'numeric', month: 'long', day: 'numeric', hour: 'numeric', minute: 'numeric' });
console.log(dtf.format(new Date()));

Other packages similar to @formatjs/intl-datetimeformat

date-fns

date-fns is a modern JavaScript date utility library that provides a comprehensive set of functions for manipulating and formatting dates. Unlike @formatjs/intl-datetimeformat, date-fns focuses on providing a functional programming approach to date manipulation and formatting.

moment

Moment.js is a widely-used JavaScript library for parsing, validating, manipulating, and formatting dates. It offers extensive support for date and time operations, but it is larger in size compared to @formatjs/intl-datetimeformat and has been deprecated in favor of more modern solutions.

luxon

Luxon is a modern JavaScript library for working with dates and times. It is built on top of the native `Intl` API and provides a more comprehensive and user-friendly API compared to @formatjs/intl-datetimeformat. Luxon also supports time zones and durations.

README

intl-datetimeformat

We've migrated the docs to https://formatjs.github.io/docs/polyfills/intl-datetimeformat