date-grab v0.1.1

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.

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