timnovis / Thyme

Dates without times or timezones

Thyme

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

Get started

import Thyme from '...'

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

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