0.1.1 • Published 4 years ago
is-my-date-valid v0.1.1
is-my-date-valid
A date validator, with support for custom formats.
Installation
npm install --save is-my-date-valid
Usage
const validator = require('is-my-date-valid')
const validate = validator({ format: 'YYYY-MM-DD' })
validate('1992-12-02') // true
validate('1992/12/02') // false
validate('1992-18-02') // false
validate(['hello', 'world']) // TypeError: expected string
API
validator(opts)
Returns a new validator, supported options:
format
: The format of the date, see the table below for valid tokens
validate(str)
Validate a date, returns true
if the date is valid, false
otherwise.
Format tokens
Input | Example | Description |
---|---|---|
YYYY | 2014 | 4 or 2 digit year |
YY | 14 | 2 digit year |
Y | -25 | Year with any number of digits and sign |
Q | 1..4 | Quarter of year |
M MM | 1..12 | Month number |
MMM MMMM | Jan..December | Month name |
D DD | 1..31 | Day of month |
Do | 1st..31st | Day of month with ordinal |
DDD DDDD | 1..365 | Day of year |
X | 1410715640.579 | Unix timestamp |
x | 1410715640579 | Unix ms timestamp |
gggg | 2014 | Locale 4 digit week year |
gg | 14 | Locale 2 digit week year |
w ww | 1..53 | Locale week of year |
e | 0..6 | Locale day of week |
ddd dddd | Mon...Sunday | Day name |
GGGG | 2014 | ISO 4 digit week year |
GG | 14 | ISO 2 digit week year |
W WW | 1..53 | ISO week of year |
E | 1..7 | ISO day of week |
H HH | 0..23 | 24 hour time |
h hh | 1..12 | 12 hour time used with a A. |
a A | am pm | Post or ante meridiem (Note the one character a p are also considered valid) |
m mm | 0..59 | Minutes |
s ss | 0..59 | Seconds |
S SS SSS | 0..999 | Fractional seconds |
Z ZZ | +12:00 | Offset from UTC as +-HH:mm, +-HHmm, or Z |