DateParser for node.js

• Introduction
• Usage
  • Install
  • Loading the module
  • Instantiating the parser
• Locales
• Methods
  • Parse
  • Load Custom Locale

Introduction

This is a simple date parsing module written in typescript; similar to the date() function of PHP. The module returns a string according to the given formatter string using the given date.

Usage

Install

Install with NPM

npm install node-date-parser

Loading the module

In a Typescript project

import the module then create the parser object.

import DateParser from 'node-date-parser';
parser = new DateParser();

In a Javascript project

require the module

const DateParser = require('node-date-parser').default;
const parser = new DateParser();

// Or do it in one step
const parser = new (require('node-date-parser').default)();

Instantiating the parser

public constructor(locale: string = "en")

The constructor expects 1 conditional argument: the locale. Check the the locale section for the available languages. If this argument is not provided the locale defaults to "en".

If an unknown locale is provided, the constructor will throw an error.

Locales

The parser is shipped with a few locale files which contains translated data. Currently these locales can be used:

• en: english
• hu: hungarian

If you would like to use the parser with a different locale you can pass a json file using the loadCustomLocale method.

Feel free to share your translated locale file with me so it can be published with the parser.

Methods

Parse

public parse(format: string, date: Date = new Date()): string

Parameters:

• format: a date formatter string. Check the reference table below for more information.
• date: an optional date object to use for the parsing. Defaults to the current date and time.

Format Reference

String formatter	Description	Example
d	Day of the month, 2 digits with leading zeros	01 to 31
D	A textual representation of a day, short.	mon through sun
E	A textual representation of a day, short, capitalized.	Mon through Sun
e	A textual representation of a day, short, uppercase.	MON through SUN
j	Day of the month without leading zeros	1 to 31
l	A full textual representation of the day of the week, lowercase.	monday through sunday
K	A full textual representation of the day of the week, capitalized.	Monday through Sunday
N	ISO 8601 numeric representation of the day of the week	1 (for Monday) through 7 (for Sunday)
w	Numeric representation of the day of the week	0 (for Sunday) through 6 (for Saturday)
z	The day of the year (starting from 0)	0 through 365
W	ISO 8601 week number of year, weeks starting on Monday	42 (the 42nd week in the year)
F	A full textual representation of a month, such as january or march, lowercase.	january through december
f	A full textual representation of a month, such as January or March, capitalized.	January through December
m	Numeric representation of a month, with leading zeros	01 through 12
M	A short textual representation of a month, short, lowercase	jan through dec
n	Numeric representation of a month, without leading zeros	1 through 12
t	Number of days in the given month	28 through 31
L	Whether it's a leap year	1 if it is a leap year, 0 otherwise.
Y	A full numeric representation of a year, 4 digits	1999 or 2003
y	A two digit representation of a year	99 or 03
a	Ante meridiem and Post meridiem, lowercase	am or pm
A	Ante meridiem and Post meridiem, capitalized	Am or Pm
B	Ante meridiem and Post meridiem, uppercase	AM or PM
c	Ante meridiem and Post meridiem, uppercase	ante meridiem or post meridiem
C	Ante meridiem and Post meridiem, capitalized	Ante meridiem or Post meridiem
g	12-hour format of an hour without leading zeros	1 through 12
G	24-hour format of an hour without leading zeros	0 through 23
h	12-hour format of an hour with leading zeros	01 through 12
H	24-hour format of an hour with leading zeros	00 through 23
i	Minutes with leading zeros	00 to 59
I	Minutes without leading zeros	0 to 59
s	Seconds with leading zeros.	00 through 59
S	Seconds without leading zeros.	0 through 59
v	Milliseconds.	15 or 654
V	Milliseconds, 3 digits.	015 or 654
U	Seconds since the Unix Epoch	1639714248

Example

// 2021-12-01 14:42:39
console.log(dateParser.parse("Y-m-d H:i:s", new Date(2021, 11, 1, 14, 42, 39)));

Load Custom Locale

public loadCustomLocale(customLocaleJson: DateParserLocale): void

If you want to use different languages with the parser which are not shipped with it, you can pass a JSON file using this method. The json must match the DateParserLocale interface.

The method itself doesn't validate the json against the interface!