1.0.0 • Published 2 years ago
@gabortorma/moment-ages v1.0.0
@gabortorma/moment-ages
This is a Moment.js plugin that calculate ages and validate a date between two ages.
Usage
common js
const moment = require('@gabortorma/moment-ages')
module (esm)
import moment from '@gabortorma/moment-ages'
setup mode
import moment from 'moment'
import setup from '@gabortorma/moment-ages/setup.js'
setup(moment)
API
The objects returned by methods are Moment.js objects (except .isBusinessDay()
and .businessDiff()
) so you can
handle them with Moment.js native methods.
.age(now: Date)
=> object
Calculate the age from moment date, based on now paramters. Now default is new Date()
. Return an object with the following structures:
{
years: Number,
months : Number,
days: Number,
}
.ageFrom(input: Date)
=> object
Calculate the age from input date, based on moment date. Return an object with the following structures:
{
years: Number,
months : Number,
days: Number,
}
.isAgeBetween(from: Number, to: Number, now: Date)
=> boolean
Check the moment date is between from and to range, based on on now paramters. Now default is new Date()
.
When range is between 30 and 40 and now is 2023-01-31'
// birth at 1993-02-01 (a day before 30th birth date)
moment('1993-02-01').isAgeBetween(30, 40, '2023-01-31') // false
// 'birth at 1993-01-31 (on 30th birth date)
moment('1993-01-31').isAgeBetween(30, 40, '2023-01-31') // true
// birth at 1982-02-01 (a day before 41th birth date)
moment('1982-02-01').isAgeBetween(30, 40, '2023-01-31') // true
// birth at 1982-01-31 (on 41th birth date)
moment('1982-01-31').isAgeBetween(30, 40, '2023-01-31') // false
Installation
// For Node.js
$ npm install @gabortorma/moment-ages
// ...or install and save in package.json
$ npm install --save @gabortorma/moment-ages
Testing
npm test
1.0.0
2 years ago