dayjs

npmv1.11.23TypeScript

2KB immutable date time library alternative to Moment.js with the same modern API

Safe to adopt

Yes — dayjs scores well across adoption, maintenance, weight, supply chain, and licensing. 48.7M downloads per week and 1 known dependents. Last published 23 days ago. 10 releases in the last 2 years.

AAdoption: grade A, Excellent.
48.7M downloads per week and 1 known dependents.
AMaintenance: grade A, Excellent.
Last published 23 days ago. 10 releases in the last 2 years.
AWeight: grade A, Excellent.
Zero runtime dependencies, about 666 KB installed.
BSupply chain: grade B, Good.
This package has a single maintainer (bus factor of 1).
ALicense: grade A, Excellent.
MIT — permissive, with no copyleft found in the dependency tree.

Grades are computed deterministically from registry metadata collected by PackageGraph — downloads, dependents, publish dates, the resolved dependency tree, maintainer count, and declared licenses. No third-party scores are used.

Install cost

What you actually take on by adding dayjs to a project.

Direct dependencies

Runtime packages this one declares itself.

Total installed

Distinct packages in the full runtime tree, deduplicated the way a package manager would.

666 KB

Install size

Unpacked size of this package plus its entire runtime tree.

—

Tree depth

Longest resolved dependency chain below this package.

Compatibility

Node.js: No constraint declared
Module format: CommonJS only
TypeScript: Types included
Install scripts: None

Quick start

A usage example from the dayjs README.

jsFull README ↗

dayjs().startOf('month').add(1, 'day').set('year', 2018).format('YYYY-MM-DD HH:mm:ss');

dayjs vs the alternatives

Packages solving a similar problem in the npm ecosystem, compared on the signals that drive an adoption decision.

Package	Weekly downloads	Dependents	License	Last release
dayjsthis page	48.7M	1	MIT	23 days ago
moment	31.5M	2	MIT	1 day ago
redux	30.2M	5	MIT	1 day ago
@reduxjs/toolkit	26.4M	2	MIT	1 day ago
immer	0	3	MIT	1 day ago
immutable	0	7	MIT	1 day ago

Dependencies

Declared by dayjs v1.11.23. Runtime dependencies are installed with the package; dev dependencies are not.

Dev (30)

@babel/cli ^7.0.0-beta.44@babel/core ^7.0.0-beta.44@babel/node ^7.0.0-beta.44@babel/preset-env ^7.0.0-beta.44@semantic-release/github ^11.0.4babel-core ^7.0.0-bridge.0babel-jest ^22.4.3babel-plugin-external-helpers ^6.22.0cross-env ^5.1.6eslint ^4.19.1eslint-config-airbnb-base ^12.1.0eslint-plugin-import ^2.10.0eslint-plugin-jest ^21.15.0gzip-size-cli ^2.1.0jasmine-core ^2.99.1jest ^22.4.3karma ^2.0.2karma-jasmine ^1.1.2karma-sauce-launcher ^1.1.0mockdate ^2.0.2moment 2.29.2moment-timezone 0.5.31ncp ^2.0.0pre-commit ^1.2.2prettier ^1.16.1rollup ^2.45.1rollup-plugin-babel ^4.4.0rollup-plugin-terser ^7.0.2size-limit ^0.18.0typescript ^2.8.3

Used by

Popular packages that depend on dayjs.

logkittynpm

Display pretty Android and iOS logs without Android Studio or Console.app, with intuitive Command Line Interface.

↓ 0/wk◈ 1 dependents⚖ MIT

Relationship graph

Dependencies (left) and dependents (right) of dayjs.

dayjs dependencies dependents

Frequently installed together

eslintnpm

An AST-based pattern checker for JavaScript.

↓ 138.4M/wk◈ 279 dependents⚖ MITTS

jestnpm

Delightful JavaScript Testing.

↓ 42.1M/wk◈ 70 dependents⚖ MITTS

@types/nodenpm

TypeScript definitions for node

↓ 0/wk◈ 327 dependents⚖ MITTS

@types/yargsnpm

TypeScript definitions for yargs

↓ 0/wk◈ 7 dependents⚖ MITTS

yargsnpm

yargs the modern, pirate-themed, successor to optimist.

↓ 0/wk◈ 12 dependents⚖ MIT

babel-jestnpm

Jest plugin to use babel for transformation.

↓ 0/wk◈ 16 dependents⚖ MITTS

@babel/preset-typescriptnpm

Babel preset for TypeScript.

↓ 0/wk◈ 13 dependents⚖ MIT

ansi-fragmentsnpm

A tiny library with builders to help making logs/CLI pretty with a nice DX.

↓ 0/wk◈ 1 dependents⚖ MIT

Release history

10 releases in the last two years, typically about 47 days apart.

Recent versions of dayjs
Version	Published	Size	License
1.11.23latest	23 days ago	666 KB	MIT
1.11.22	24 days ago	665 KB	MIT
1.11.21	3 months ago	664 KB	MIT
1.11.20	6 months ago	664 KB	MIT
1.11.19	10 months ago	663 KB	MIT
1.11.18	1 year ago	657 KB	MIT
1.11.17	1 year ago	657 KB	MIT
1.11.16	1 year ago	659 KB	MIT
1.11.15	1 year ago	656 KB	MIT
1.11.14	1 year ago	655 KB	MIT
1.11.13	2 years ago	655 KB	MIT
1.11.12	2 years ago	653 KB	MIT
1.11.11	2 years ago	650 KB	MIT
1.11.10	3 years ago	648 KB	MIT
1.11.9	3 years ago	641 KB	MIT

Overview

dayjs is an npm package that 2KB immutable date time library alternative to Moment.js with the same modern API. It is extremely widely used, with about 48.7M downloads per week and 1 known dependents in the graph. The latest version is 1.11.23, released under the MIT license.

Who should use it

Teams working in the npm ecosystem who need 2KB immutable date time library alternative to Moment.js with the same modern API and value a battle-tested, widely-adopted solution.

When not to use it

Consider an alternative if you need to minimize your dependency tree, or if a more actively-maintained option better fits your npm stack.

Pros

Large, well-established user base (48.7M weekly downloads).
Ships TypeScript type definitions.
Clear open-source license (MIT).

Cons

Large dependency tree (30 direct dependencies) increases install size and audit surface.

Auto-generated from collected registry metadata. No external claims are inferred.

Maintainers

iamkun

Keywords

date dayjs immutable moment time

Frequently asked questions

Should I use dayjs?

How do I install dayjs?

Run `npm install dayjs` to add dayjs to your npm project.

What license is dayjs released under?

dayjs is distributed under the MIT license.

How popular is dayjs?

dayjs has approximately 48,716,594 downloads per week and 1 known dependent packages.

Is dayjs still maintained?

The most recent release of dayjs (v1.11.23) was published 23 days ago.

Does dayjs run install scripts?

No. dayjs does not define preinstall, install, or postinstall scripts, so installing it does not execute publisher-supplied code.