intl-relativeformat

What is intl-relativeformat?

The intl-relativeformat npm package is used for formatting relative dates and times in a human-readable way. It leverages the Internationalization API to provide locale-aware formatting, making it easier to display dates and times relative to the current date and time.

What are intl-relativeformat's main functionalities?

Basic Relative Time Formatting

This feature allows you to format a date relative to the current time. In this example, it formats a date that is one hour ago.

const IntlRelativeFormat = require('intl-relativeformat');
const rf = new IntlRelativeFormat('en');
console.log(rf.format(Date.now() - 1000 * 60 * 60)); // 'an hour ago'

Locale-Specific Formatting

This feature allows you to format dates relative to the current time in a locale-specific manner. In this example, it formats a date that is one hour ago in French.

const IntlRelativeFormat = require('intl-relativeformat');
const rf = new IntlRelativeFormat('fr');
console.log(rf.format(Date.now() - 1000 * 60 * 60)); // 'il y a une heure'

Future Date Formatting

This feature allows you to format future dates relative to the current time. In this example, it formats a date that is one hour in the future.

const IntlRelativeFormat = require('intl-relativeformat');
const rf = new IntlRelativeFormat('en');
console.log(rf.format(Date.now() + 1000 * 60 * 60)); // 'in an hour'

Other packages similar to intl-relativeformat

moment

Moment.js is a widely-used library for parsing, validating, manipulating, and formatting dates. It provides relative time formatting through its `fromNow` and `toNow` methods. Compared to intl-relativeformat, Moment.js offers a broader range of date manipulation features but is larger in size.

date-fns

date-fns is a modern JavaScript date utility library that provides a variety of functions for working with dates, including relative time formatting through its `formatDistance` and `formatDistanceToNow` functions. It is modular and tree-shakeable, making it a lightweight alternative to Moment.js.

luxon

Luxon is a modern JavaScript library for working with dates and times, created by one of the Moment.js developers. It provides relative time formatting through its `toRelative` and `toRelativeCalendar` methods. Luxon is built on top of the native JavaScript Internationalization API, similar to intl-relativeformat, but offers a more comprehensive set of features.

README

Intl RelativeFormat

Formats JavaScript dates to relative time strings.