@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

README for the tz distribution

"Where do I set the hands of the clock?" -- Les Tremayne as The King "Oh that--you can set them any place you want." -- Frank Baxter as The Scientist (from the Bell System film "About Time")

The Time Zone Database (called tz, tzdb or zoneinfo) contains code and data that represent the history of local time for many representative locations around the globe. It is updated periodically to reflect changes made by political bodies to time zone boundaries, UTC offsets, and daylight-saving rules.

See https://www.iana.org/time-zones/repository/tz-link.html or the file tz-link.html for how to acquire the code and data. Once acquired, read the comments in the file 'Makefile' and make any changes needed to make things right for your system, especially if you are using some platform other than GNU/Linux. Then run the following commands, substituting your desired installation directory for "$HOME/tzdir":

make TOPDIR=$HOME/tzdir install
$HOME/tzdir/usr/bin/zdump -v America/Los_Angeles

This database of historical local time information has several goals:

• Provide a compendium of data about the history of civil time that is useful even if not 100% accurate.

• Give an idea of the variety of local time rules that have existed in the past and thus may be expected in the future.

• Test the generality of the local time rule description system.

The information in the time zone data files is by no means authoritative; fixes and enhancements are welcome. Please see the file CONTRIBUTING for details.

Thanks to these Time Zone Caballeros who've made major contributions to the time conversion package: Keith Bostic; Bob Devine; Paul Eggert; Robert Elz; Guy Harris; Mark Horton; John Mackin; and Bradley White. Thanks also to Michael Bloom, Art Neilson, Stephen Prince, John Sovereign, and Frank Wales for testing work, and to Gwillim Law for checking local mean time data. Thanks in particular to Arthur David Olson, the project's founder and first maintainer, to whom the time zone community owes the greatest debt of all. None of them are responsible for remaining errors.

---

This file is in the public domain, so clarified as of 2009-05-17 by Arthur David Olson. The other files in this distribution are either public domain or BSD licensed; see the file LICENSE for details.