luxon

What is luxon?

Luxon is a powerful, modern, and friendly wrapper for JavaScript dates and times. It enables parsing, formatting, manipulation, and querying of dates and times in JavaScript.

What are luxon's main functionalities?

DateTime Manipulation

Luxon allows for easy manipulation of DateTime objects. You can add or subtract time units, and perform other modifications.

{"DateTime": require('luxon').DateTime; let now = DateTime.now(); let later = now.plus({ hours: 3 });}

Formatting Dates

With Luxon, you can format dates according to different patterns, making it easy to display dates in a user-friendly format.

{"DateTime": require('luxon').DateTime; let now = DateTime.now(); let formatted = now.toFormat('yyyy LLL dd');}

Parsing Dates

Luxon provides functions to parse dates from strings, including ISO 8601 formats, SQL dates, and more.

{"DateTime": require('luxon').DateTime; let dt = DateTime.fromISO('2020-05-15T08:30:00');}

Internationalization

Luxon supports internationalization, allowing dates to be displayed in different languages and formats based on locale settings.

{"DateTime": require('luxon').DateTime; let now = DateTime.now(); let localized = now.setLocale('fr').toLocaleString(DateTime.DATE_FULL);}

Querying and Comparison

You can use Luxon to compare dates and times, calculate durations between them, and query properties like how many days are between two dates.

{"DateTime": require('luxon').DateTime; let now = DateTime.now(); let christmas = DateTime.local(2023, 12, 25); let daysUntilChristmas = now.until(christmas).count('days');}

Other packages similar to luxon

moment

Moment.js is a legacy date manipulation library that offers similar functionalities to Luxon. However, Luxon is more modern and has a better focus on immutability and internationalization.

date-fns

date-fns is a modular date utility library that provides the most comprehensive, yet simple and consistent toolset for manipulating JavaScript dates. It's functional and has a simple API, but doesn't handle time zones as Luxon does.

dayjs

Day.js is a minimalist JavaScript library that parses, validates, manipulates, and displays dates and times for modern browsers with a largely Moment.js-compatible API. It is lightweight and also does not offer time zone support out of the box like Luxon.

README

Luxon

Luxon is a library for working with dates and times in JavaScript.

DateTime.now().setZone("America/New_York").minus({ weeks: 1 }).endOf("day").toISO();

Upgrading to 3.0

Guide

Features

• DateTime, Duration, and Interval types.
• Immutable, chainable, unambiguous API.
• Parsing and formatting for common and custom formats.
• Native time zone and Intl support (no locale or tz files).

Download/install

Download/install instructions

Documentation

• General documentation
• API docs
• Quick tour
• For Moment users
• Why does Luxon exist?
• A quick demo

Development

See contributing.

Changelog

3.5.0 (2024-08-03)

• Various performance improvements
• throwOnInvalid causes the constructor to throw if the year is invalid