date-grab

Date Grab

Date grab provides a thin functional wrapper for getting Date object properties.

Useage

var grab = require('date-grab');
var countdown = new Date('July 1, 2015');

var year = grab('year')
  // year(countdown) === 2015

var date = grab('date')
  // date('December 22, 2015') === 22 

var utcHours = grab('hours', { utc: true })
  // utcHours(countdown) === 7(PST)

var monthYear = grab(['month', 'year'])
  // monthYear(countdown) === { month: 6, year: 2015 }

grab(property, options)

Date grab creates a function that gets date property, wraps standard Date object functions. property should be a String or String Array and config should be an Object.

More thorough documentation on Dates can be found at MDN, but here is a basic conversion chart.

grab	date
grab('time')(date)	date.getTime()
grab('timezone')(date)	date.getTimezoneOffset()
grab('year')(date)	date.getYear()
grab('month')(date)	date.getMonth()
grab('date')(date)	date.getDate()
grab('day')(date)	date.getDay()
grab('hours')(date)	date.getHours()
grab('minutes')(date)	date.getMinutes()
grab('seconds')(date)	date.getSeconds()
grab('milliseconds')(date)	date.getMilliseconds()

options

utc

Setting utc to true will use UTC instead of local date functions.

var now = new Date()
var utcHours = grab('hours', { utc: true })

utcHours(now) === now.getUTCHours() // true