luxon README

The project's README from github.com/moment/luxon. As one markdown file: README.md.

Luxon

MIT License Build Status NPM version Coverage Status PRs welcome

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

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

🚀 The road to Luxon 4.0

Please read about and share your feedback on the plans for the next major version of Luxon!

Upgrading to 3.0

Guide

Features

Download/install

Download/install instructions

Documentation

Development

See contributing.

Phasers to stun

luxon (moment/luxon)

Searching Database…

16.5K ·GitHub
What is this?Luxon is a JavaScript library for working with dates and times — parsing, formatting, and date math, with built-in time zone support.
Is this Moment.js, or a different project?A different project: a standalone library you add to a JS codebase. It lives in the Moment GitHub org, which offers Moment users a guide titled 'Why does Luxon exist?'.
How do I add it to a project?Install the luxon package from npm and import it into your code; the README links to detailed install instructions and documentation.
Does it pull in other packages or need a specific environment?No runtime dependencies — it's self-contained JavaScript. The package targets Node.js 12 or newer, and it also runs directly in the browser.
Do I have to ship locale or timezone data files with it?No — Luxon uses the native time zone and Intl support built into JavaScript, so there are no locale or tz files to load or bundle.
Where does it run?It's pure JavaScript with no OS-specific code — it runs in Node.js 12+ and in the browser.
What are the core object types?Three main types: DateTime for a point in time, Duration for a length of time, and Interval for the span between two points.
Can I chain operations without mutation surprises?Yes — the API is immutable and chainable: operations return new values instead of changing existing objects, which keeps date math predictable.
Which date formats can it parse and produce?Both common and custom formats — parsing and formatting are built in, so you can read standard strings and output your own layouts.
Is the project still evolving?Yes — the README invites users to read and comment on the plans for Luxon 4.0, the next major version, and there's a separate upgrade guide for 3.0.
Creator
moment
Size
98.3 MB
Stars
16.5K
Updated
CommitAug 09
Age
10y
Commits · 90 Days