Skip to content
Functionally grab properties of a date object
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.

Date Grab

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


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()



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
You can’t perform that action at this time.
You signed in with another tab or window. Reload to refresh your session. You signed out in another tab or window. Reload to refresh your session.