date-lube v1.4.2

Date Lube

Simplify Date Manipulation in JavaScript

Working with dates in JavaScript can often be challenging, especially when it comes to parsing, formatting, and performing calculations.
However, with the "date-lube" library, managing dates becomes a seamless experience.
This powerful JavaScript library provides a comprehensive set of functions that simplify date manipulation tasks and empower developers to work efficiently with dates.

Installation

npm i date-lube

pnpm i date-lube

bun i date-lube

How to use

To convert Date time

import { add } from "date-lube"

var d: Date = add(new Date, "-2Y")
//=> Date { 2 year ago }

var d: Date = add(new Date, "-1D")
//=> Date { yesterday }

var d: Date = add(new Date(0), "1Y2M-3D 4H 5m6s -7sss")
//=> Date { 1971-02-26T04:05:05.993Z }

var d: Date = add(new Date(0), "1Y-3D2M 4H 5m6s -7sss")
//=> Date { 1971-03-01T04:05:05.993Z }

To convert Date to String

import { dateToString } from "date-lube"

var s: string = dateToString(new Date("2222-03-04T11:22:33.444"))
//=> "2222-03-04T11:22:33.444"

var s: string = dateToString(
    new Date("2222-03-04T11:22:33.444"),
    "HHhmmmssSsss _ YYYY/MM/DD"
)
//=> "11h22m33s444 _ 2222/03/04"

To convert String to Date

import { stringToDate } from "date-lube"

var d: Date = stringToDate("2222-03-04T11:22:33.444")
//=> Date { 2222-03-04T11:22:33.444 in Locale }

var d: Date = stringToDate(
    "11h22m33s444 _ 2222/03/04",
    "HH mm ss sss _ YYYY MM DD"
)
//=> Date { 2222-03-04T11:22:33.444 in Locale }

To convert Date using time zone offset

import { timeZone } from "date-lube"
import { TimeZone } from "date-lube/@types"

var d: Date = new Date// UTC+9
//=> Date { now }

var d: Date = timeZone(new Date, "Europe/London")
//=> Date { 8 or 9 hours ago }

var d: Date = timeZone(new Date, "America/New_York")
//=> Date { 13 or 14 hours ago }

var d: Date = timeZone(new Date, "America/New_York", true)
//=> Date { 13 or 14 hours later }

var arr: TimeZone[] = ["America/New_York", "Zulu"]
for (var tz of arr) {
	timeZone(new Date, tz)
}

Time Unit

import { timeUnit } from "date-lube"

typeof timeUnit == {
	DD: 86400000// 1day = 86400000ms
	HH: 3600000// 1hour = 3600000ms
	mm: 60000// 1minute = 60000ms
	ss: 1000// 1second = 1000ms
}