kk-date

kk-date is a fastest JavaScript library that parses, validations, manipulates, and displays dates and times. If you use Moment.js or Day.js already you can easily use kk-date.

• 🕒 Familiar Moment.js API & Day.js
• 💪 Immutable
• 🔥 Chainable
• 🚀 Native Date
• 🏁 Performance
• ✅ All browsers supported

Install

npm install kk-date

Performance

if the same function is called 400k times.

date: '23:50:55' expected format: YYYY-MM-DD HH:mm:ss

| Package | ms | | :-------- | :------------------------- | | kk-date | 446.264ms | WIN! | moment | 933.953ms | | day.js | 1267ms |

date: '2024-09-17 23:50:55' expected format: HH:mm:ss

| Package | ms | | :-------- | :------------------------- | | kk-date | 111.182ms | WIN! | day.js | 588.194ms | | moment | 1760ms |

diff 2024-01-01 - 2024-01-30

| Package | ms | | :-------- | :------------------------- | | kk-date | 127.343ms | WIN! | day.js | 313.93ms | | moment | 1806ms |

API

It's easy to use kk-date to parse, validate, manipulate, and display dates and times.

REQUIRE:

  const kk_date = require('kk-date');

Examples:

format:

new kk_date('2024-01-01 23:00:00').format('YYYY-MM-DD')
// 2024-01-01

format:

new kk_date('2024-01-01 23:00:00').format('HH:mm:ss')
// 23:00:00

format:

new kk_date('2024-01-01 23:00:00').format('YYYY-MM-DD HH:mm:ss')
// 2024-01-01 23:00:00

add:

new kk_date('2024-01-01').add(1, 'days').format('YYYY-MM-DD')
// 2024-01-02

add (subtract):

new kk_date('2024-01-05').add(-1, 'days').format('YYYY-MM-DD')
// 2024-01-04

set (day):

new kk_date('2024-01-05').set(1, 'day').format('YYYY-MM-DD')
// 2024-01-01

set (month):

new kk_date('2024-01-05').set(3, 'month').format('YYYY-MM-DD')
// 2024-03-05

diff:

new kk_date('2024-07-19').diff('2024-09-19', 'months')
// 2

diff_range:

new kk_date('2024-07-19').diff_range('2024-09-19', 'months')
// [ '2024-07-19', '2024-08-18', '2024-09-18' ]

isBefore:

new kk_date('2024-09-19').isBefore('2024-09-20')
// true

isAfter:

new kk_date('2024-09-19').isAfter('2024-09-20')
// false

isSameOrAfter:

new kk_date('2024-09-19 18:00:00').isSameOrAfter('2024-09-19 18:01:00')
// false

isSame:

new kk_date('2024-09-19 18:00:00').isSame('2024-09-19 18:00:00')
// true

isBetween:

new kk_date('2024-09-19 18:00:00').isBetween('2024-09-19 12:00:00', '2024-09-19 19:00:00')
// true

Others:

.toDateString();

.toJSON();

.toUTCString();

.toLocaleDateString(locales, options);

.toLocaleString(locales, options);

.toLocaleTimeString(locales, options);

.toTimeString();

.valueOf();

Notes:

The kk-date package is designed with simplicity and performance in mind, offering a streamlined way to handle date objects in JavaScript. When you instantiate the class, you can effortlessly access the native JavaScript Date object via the date key, making it intuitive for those familiar with the standard Date API.

Key Features

• Simplicity at its Core: The package is written to be as straightforward as possible, minimizing overhead and ensuring ease of use for basic date handling.
• Direct Access to Native Date: Seamlessly work with the native Date object, giving you the full power of JavaScript's built-in date functionalities.
• Optimized for Performance: If speed and efficiency are critical for your application, kk-date is the perfect fit, delivering performance without sacrificing usability.
• Ongoing Development: While kk-date is currently tailored for basic date operations, we are actively developing it to support more complex date manipulations and formats in future releases.

Whether you're building a lightweight application or need a reliable solution for high-performance date handling, kk-date is the package you’ve been looking for.

.format() supported templates:

YYYY-MM-DDTHH:mm:ss
YYYY-MM-DD HH:mm:ss
YYYY-MM-DD HH:mm
YYYY-MM-DD HH
YYYY-MM-DD
YYYYMMDD
DD.MM.YYYY
YYYY.MM.DD
YYYY.MM.DD HH:mm
YYYY.MM.DD HH
YYYY.MM.DD HH:mm:ss
DD.MM.YYYY HH:mm:ss
DD.MM.YYYY HH:mm
DD-MM-YYYY
DD-MM-YYYY HH:mm
DD-MM-YYYY HH:mm:ss
DD-MM-YYYY HH
dddd
HH:mm:ss
HH:mm
x (Unix timestamps in milliseconds),
X (Unix timestamps in seconds)

.add() supported types:

seconds
minutes
hours
days
months
years

Performance Tests:

| Test No | input | Output | kk-date | Moment | Day.js | date-fns | |---------|----------------------------------|------------------------|----------------|---------------|---------------|-----------------| | Test 0 | new Date | 2024-09-04 15:30:00 | 337.529ms | 374.127ms | N/A | 799.957ms | | Test 1 | 23:50:55 | 2024-09-04 23:50:55 | 450.225ms | 954.643ms | 1.202s | 807.904ms | | Test 2 | 23:50 | 23:50 | 410.597ms | 591.453ms | 796.459ms | 331.762ms | | Test 3 | 23:50:55 | 2024.09.04 23:50:55 | 451.571ms | 952.301ms | 1.183s | 798.924ms | | Test 4 | 2024-09-17 23:50:55 | 23:50:55 | 123.55ms | 1.635s | 569.191ms | N/A | | Test 5 | 2024-09-17 23:50:55 | 2024-09-17 | 119.81ms | 1.620s | 571.845ms | N/A | | Test 6 | 2024-09-17 23:50:55 | 2024-09-17 23:50:55 | 163.857ms | 1.769s | 721.491ms | N/A | | Test 7 | 2024-09-17 23:50:55 | 17.09.2024 23:50:55 | 162.367ms | 1.787s | 740.896ms | N/A | | Test 8 | 2024-09-17 23:50:55 | 2024.09.17 23:50:55 | 163.413ms | 1.789s | 738.167ms | N/A | | Test 9 | 23:50:55 isValid | Boolean | 350.785ms | 671.449ms | N/A | N/A | | Test 10 | 1723996677 | 27.08.2024 05:51:17 | 139.895ms | 416.96ms | 797.691ms | N/A | | Test 11 | 19843077000 | 27.08.2056 05:55:00 | 138.668ms | 414.394ms | 757.555ms | N/A | | Test 12 | 19843077000 | 27.08.2056 05:55:00 | 136.85ms | 416.481ms | 753.213ms | N/A | | Test 13 | diff (days) 2024-01-01, 2024-01-30 | 29 | 149.738ms | 1.662s | 312.043ms | N/A | | Test 14 | isBefore 2024-01-01, 2024-01-30 | true | 122.651ms | 1.617s | 345.618ms | N/A | | Test 15 | isBetween 2024-01-01, 2024-01-30 | true | 174.48ms | 2.357s | 717.21ms | N/A | | Test 16 | isAfter 2024-01-01, 2024-01-30 | true | 115.112ms | 1.565s | 335.345ms | N/A | | Test 17 | isSame 2024-01-01 | true | 114.669ms | 1.576s | 456.979ms | N/A |