1.0.1 • Published 7 years ago

nearest-date v1.0.1

Weekly downloads
323
License
MIT
Repository
github
Last release
7 years ago

nearest-date

Given an array of dates, this module will find the date nearest to a given target date. Can be used to find the nearest number as well.

Build status js-standard-style

Installation

npm install nearest-date

Usage

var nearest = require('nearest-date')

var dates = [
  new Date('2012-12-12'),
  new Date('2024-12-12'),
  new Date('2022-12-12'),
  new Date('2016-12-12'),
  new Date('1980-12-12'),
]
var target = new Date('2016-12-27')

var index = nearest(dates, target)

console.log('Winner:', dates[index])

API

index = nearest(array[, target])

Finds the value in the array nearest to the target and returns the index of that value in the array.

The target defaults to Date.now().

Both the array and the target can be either Date objects or numbers.

License

MIT