DateTime Next

Next gen Date and Time manipulation library designed with performance in mind, it is extremely lightweight. It is about 3.5Kb minified and gzipped.

Does not use any static data such as localization files, everything comes from built in Intl object. However, this can be overridden if you provide your own Month names.

DateTime is designed to only operate on UTC date and time. It has however support for formatting date and time in user specified locale and timezone.

DateTime is specifically built as Mutable object, if you wish to use immutable object use DateTimeImmutable instead. Read more about this choice here

Zero dependencies.

WARNING: API is not yet final

Requirements

Technically it should have no requirements, For node recommended version 8+. For browser, it's the existence of Intl object.

Docs

Read the docs here

Installation

For yarn:

yarn add datetime-next

For npm:

npm i datetime-next

For browser just include the script or import it via ES6 import statement.

Some examples

Imports:

// ES6 JS/Typescript style
import { DateTime } from 'datetime-next';
// OR
import { DateTime } from 'datetime-next/DateTime';

// require

const { DateTime } = require('datetime-next');

Basic usage:

const dt = new DateTime(); // Current datetime in UTC
dt.addHour(1); // Add one hour
dt.getString('YYYY-MM-DD'); // format date ex `2021-06-21`
dt.getString('HH:mm:ss'); // format time `15:25:41`

Format properties:

| Symbol | Description | Example | | :------ | :------ | :------ | | YY | Year in 2 digit format | 21 | | YYYY | Year in full format | 2021 | | M | Month digit not padded with zeros | 4 | | MM | Month padded to 2 digits | 04 | | MMM | Short locale aware month name | Dec | | MMMM | Long locale aware month name | December | | d | Weekday number | 5 | | dd | Weekday locale aware narrow name | F | | ddd | Weekday locale aware short name | Fri | | dddd | Weekday locale aware short name | Friday | | D | Day of month not padded | 9 | | DD | Day of month padded to 2 digits | 09 | | H | Hour in 24h format not padded | 7 | | HH | Hour in 24h format padded to 2 digits | 07 | | h | Hour in 12h format not padded | 7 | | hh | Hour in 12h format padded to 2 digits | 07 | | a | Meridian locale aware in lowercase | am | | A | Meridian locale aware in uppercase | AM | | m | Minute not padded | 5 | | mm | Minute padded to 2 digits | 05 | | s | Second not padded | 3 | | ss | Second padded to 2 digits | 03 | | SSS | Milliseconds padded to 3 digits | 245 | | Z | Timezone offset from UTC with colon | +02:00 | | ZZ | Timezone offset from UTC without colon | +02:00 |