sleavely / next-monthly

Determine the next monthly occurence of a JS date, falling back on the last day of the month

next-monthly

Determine the next monthly occurence, falling back on the last day of the month.

Installation

npm i next-monthly

Usage

const nextMonthly = require('next-monthly')

// Jan 31, Feb 28 or 29, etc.
const lastDayOfThisMonth = nextMonthly()

// If you want to charge users who signed up on the 30th (but sometimes on Feb 28, etc.)
const nextBillingDate = nextMonthly({
  from: '1990-01-07T01:29:03.999Z',

  // Defaults to Date.now(). Only used here for demo purpose:
  now:  '2022-08-23T12:29:08.551Z',
})
// Date: 2022-09-07T01:29:03.999Z

Options

Property	Description
from	The basis for the monthly occurrance. Defaults to 0000-01-31T00:00:00.000Z for a classic last-day-of-month experience.
now	The point in time from which to look for the next occurance. Defaults to Date.now().

See also

• rrule - Library for working with recurrence rules for calendar dates according to RFC 5545.

next-monthly's Issues

Add `offset` option

As a consumer of next-monthly I don't want to have to figure out how to add or subtract months to show upcoming or past billing dates.

Suggested additional option and its behavior:

const nextBillingDate = nextMonthly({
  from: '1990-01-07T01:29:03.999Z',
  now:  '2022-08-23T12:29:08.551Z',
  offset: -1, // <- This is new. Could default to 0
})
// 2022-08-07T01:29:03.999Z instead of 2022-09-07T01:29:03.999Z

Missing repo&homepage in package.json

There's no repository or homepage properties in package.json, causing npm to not link back to the repo.