Tick

Utilities for working with dates indifferent to timezone.

Features:

Adding/subtracting
Constants
Getters
Starters & Enders

For the sake of avoiding repetition, assume that there is a line importing Tick in all examples.

Adding/Subtracting

const today = Tick.date();

// add a day
const tomorrow = today + Tick.$.Day;

// subtract a week
const lastWeek = today - Tick.$.Week;

// next year, 2 weeks ago, 4 days back
const random = today + (2 * Tick.$.Weeks) - (4 * Tick.$.Days)

Constants

For the sake of transparency, the constants used within this module are exported on the Tick identifier. This is mostly to avoid confusions around ordering of certain things (i.e. which day of the week is first? is January 1 or 0?).

All numbers will start at 0 (month of year, day of week) with the exception of the date itself, since that is universally considered to start at 1.

Tick.Days = [
  'Sunday',
  'Monday',
  // etc.
]

Tick.Months = [
  'January',
  'February',
  // etc.
]

Getters

`.getDayOfMonth(date)`

Returns number: an integer representing the day of the month (i.e. date).

Starters & Enders

Jumping to the start of something

Possible units:

month (takes you to day 1 in the month)

Example:

const today = Tick.date('Mar ...')
Tick.startOf(today, 'month') // returns 3

License

Licensed under the MIT license.

richardison/tick