date-timer v0.0.12
Date Timer
Date Timer is a simple date timer library written in Typescript. Currently the core is being developed so do not use for production codebases yet.
Installation
Use yarn or npm to install date-timer
# Yarn
yarn add date-timer
#npm
npm i date-timer
Usage
// ES5
const DateTimer = require('date-timer')
const date = new DateTimer()
// Creates a new date timer object with the current timestamp
// ES6+
import DateTimer from 'date-timer'
const date = new DateTimer()
// Creates a new date timer object with the current timestamp
Method chaining
Most methods in the DateTimer class return the DateTimer object so chaining methods is available
Example
const date = new DateTimer() // 2020-01-01T00:00:00.000Z
date.addYears(2).addMonths(3).addDays(2) // 2022-04-03T00:00:00.000Z
Documentation
Date Timer Methods
addYears(years: number): DateTimer
Adds years to the date. Returns the DateTimer Object.
const date = new DateTimer() // 2020-01-01
date.addYears(1) // 2021-01-01
addMonths(months: number): DateTimer
Adds months to the date. Returns the DateTimer Object.
const date = new DateTimer() // 2020-01-01
date.addMonth(1) // 2020-02-01
addWeeks(weeks: number): DateTimer
Adds weeks to the date. Returns the DateTimer Object.
const date = new DateTimer() // 2020-01-01
date.addWeeks(1) // 2020-01-08
addDays(days: number): DateTimer
Adds days to the date. Returns the DateTimer Object.
const date = new DateTimer() // 2020-01-01
date.addDays(1) // 2020-01-02
addHours(hours: number): DateTimer
Adds hours to the date. Returns the DateTimer Object.
const date = new DateTimer() // 2020-01-01T00:00:00.000Z
date.addHours(1) // 2020-01-01T01:00:00.000Z
addMinutes(minutes: number): DateTimer
Adds minutes to the date. Returns the DateTimer Object.
const date = new DateTimer() // 2020-01-01T00:00:00.000Z
date.addMinutes(1) // 2020-01-01T00:01:00.000Z
addSeconds(seconds: number): DateTimer
Adds seconds to the date. Returns the DateTimer Object.
const date = new DateTimer() // 2020-01-01T00:00:00.000Z
date.addSeconds(1) // 2020-01-01T00:00:01.000Z
addMilliseconds(seconds: number): DateTimer
Adds milliseconds to the date. Returns the DateTimer Object.
const date = new DateTimer() // 2020-01-01T00:00:00.000Z
date.addMilliseconds(1) // 2020-01-01T00:00:00.001Z
subYears(years: number): DateTimer
Subtracts years from the date. Returns the DateTimer Object.
const date = new DateTimer() // 2020-01-01
date.subYears(1) // 2019-01-01
subMonths(months: number): DateTimer
Subtracts months from the date. Returns the DateTimer Object.
const date = new DateTimer() // 2020-01-01
date.subMonths(1) // 2019-12-01
subWeeks(weeks: number): DateTimer
Subtracts weeks from the date. Returns the DateTimer Object.
const date = new DateTimer() // 2020-01-01
date.subWeeks(1) // 2019-12-25
subDays(days: number): DateTimer
Subtracts days from the date. Returns the DateTimer Object.
const date = new DateTimer() // 2020-01-01
date.subDays(1) // 2019-12-31
subHours(hours: number): DateTimer
Subtracts hours from the date. Returns the DateTimer Object.
const date = new DateTimer() // 2020-01-01T00:00:00.000Z
date.subHours(1) // 2019-12-31T23:00:00.000Z
subMinutes(minutes: number): DateTimer
Subtracts minutes from the date. Returns the DateTimer Object.
const date = new DateTimer() // 2020-01-01T00:00:00.000Z
date.subMinutes(1) // 2019-12-31T23:59:00.000Z
subSeconds(seconds: number): DateTimer
Subtracts seconds from the date. Returns the DateTimer Object.
const date = new DateTimer() // 2020-01-01T00:00:00.000Z
date.subSeconds(1) // 2019-12-31T23:59:59.000Z
subMilliseconds(seconds: number): DateTimer
Subtracts milliseconds from the date. Returns the DateTimer Object.
const date = new DateTimer() // 2020-01-01T00:00:00.000Z
date.subMilliseconds(1) // 2019-12-31T23:59:59.999Z
Roadmap
- Build for web
- Add more comparison methods
Contributing
Pull requests are welcome. For major changes, please open an issue first to discuss what you would like to change.
Please make sure to update tests as appropriate.