DateStringify

A minimal, practical date format library.

Installation

$ npm install datestringify

Usage

const dateStringify = require('datestringify');

// Sat May 16 2020 13:45:30 GMT+0800
const date = new Date(2020, 4, 16, 13, 45, 30, 666);

// '2020-05-16'
console.log(dateStringify('yyyy-MM-dd', date))

// '2020/05/16'
console.log(dateStringify('yyyy/MM/dd', date))

// '2020-5-16'
console.log(dateStringify('yyyy-M-d', date))

// '2020-05-16 13:45:30'
console.log(dateStringify('yyyy-MM-dd HH:mm:ss', date))

// '2020-05-16 13:45:30 666'
console.log(dateStringify('yyyy-MM-dd HH:mm:ss sss', date))

// 12-hour '2020-05-16 01:45:30'
console.log(dateStringify('yyyy-MM-dd HH:mm:ss', date, { use12hour: true }))

// 12-hour '2020-05-16 1:45:30'
console.log(dateStringify('yyyy-MM-dd H:m:s', date, { use12hour: true }))

Syntax

dateStringify(formatString, date, option)

formatString

Required, <string>

|Format|Description| |--|--| |YYYY, yyyy|The decimal digits of the year 0000 to 9999 in the Gregorian calendar| |YY, yy|The decimal digits of the year 00 to 99 in the Gregorian calendar| |MM| The month of the year from 01 (January) to 12 (December)| |M| The month of the year from 1 (January) to 12 (December)| |DD, dd| The day of the month from 01 to 31| |D, d| The day of the month from 1 to 31| |HH, hh| The number of complete hours that have passed since midnight as two decimal digits from 00 to 24| |H, h| The number of complete hours that have passed since midnight as a decimal digits from 0 to 24| |mm| The number of complete minutes since the start of the hour as two decimal digits from 00 to 59| |m| The number of complete minutes since the start of the hour as a decimal digits from 0 to 59| |SS, ss| The number of complete seconds since the start of the minute as two decimal digits from 00 to 59| |S, s| The number of complete seconds since the start of the minute as a decimal digits from 0 to 59| |SSS, sss| The number of complete milliseconds since the start of the second as three decimal digits from 000 to 999|

date

Required, <Date | timestamp | dateString>

option

Optional, and the default is:

{
    utc: false, // true: use UTC, otherwise use local time zone
    use12hour: false
}

Run UT

To run the test suite, first install the dependencies, then run npm test:

$ npm install
$ npm test