@trys/thyme

Thyme

For when you need dates, but not times, and certainly not timezones.

Get started

npm i @trys/thyme

import Thyme from '@trys/thyme'

const a = new Thyme('2018-10-02')
const b = new Thyme('2018-10-05')

Comparison

a.equals(b)
// false

a.equals(a)
// true

a.equals(new Thyme('2018-10-02'))
// true

new Thyme('2018-10-02').equals('2018-10-02')
// true

Range of dates

const range = a.till(b)

range.contains(a)
// true

The contains method can be added to any array, plus it'll convert any strings into Thyme objects making it a neat way to convert multiple dates to Thyme.

const range = new Thyme().range([ '2018-02-12' ])
range.contains('2018-02-12')
// true

Date-like methods

a.getFullYear()
// 2018

/* Note, zero-based */
a.getMonth()
// 9

a.getDate()
// 2

a.getDay()
// 2

Add/Remove days

Thyme objects are mutable, so calling a.add() or a.remove() will return the new date AND mutate a.

a.add()
// 2018-10-03

a.add(2)
// 2018-10-05

a.remove()
// 2018-10-04

Basic formatting

a.format()
// 4 October 2018