nodejs-support-dates

calculate planned Node.js support windows based on LTS plans

What is this?

This project hardcodes a few key dates for past releases, and otherwise calculates key dates for current and future releases.

The behaviour of this project is based upon:

• upstream Node.js Long-Term Support schedule: https://github.com/nodejs/LTS

• dates of previous releases: https://github.com/nodejs/node/releases

• change logs for previous releases: https://github.com/nodejs/node/blob/master/doc/changelogs/

The purpose of this project is to allow other tools to make useful and accurate recommendations to Node.js users.

Usage

API

datesFromVersion (version)

• version: number (major version) | string (e.g. "1.2.3")

• returns: { release: '...', end: '...' } (values are Dates)

This will return accurate dates for versions listed at: https://github.com/nodejs/LTS

Other versions will result in incorrect dates set in the distant past, as this is sufficient for the primary purpose of this library.

Example:

var datesFromVersion = require('nodejs-support-dates').datesFromVersion

JSON.stringify(datesFromVersion(process.version), null, 2)
/* if run within Node.js 6.x, will return
{
  "release": "2016-04-01T00:00:00.000Z",
  "end": "2019-04-01T00:00:00.000Z"
}
*/

// example uses `JSON.stringify()` to more easily illustrate the `Date` values

ltsFromDate (date)

• date: string (ISO8601) | Date

• returns: number (major version)

Example:

var ltsFromDate = require('nodejs-support-dates').ltsFromDate

ltsFromDate('2016-04-01') // => 6
ltsFromDate(new Date()) // => 6