Overview

This is a date formatting library based on Steven Levithan's Date Format 1.2.3, that attempts to stay closer to Unicode locale data markup language standard.

Installation and usage

Use npm to get the library and reference it on your HTML page

npm install date-format-ldml

The library is AMD and Commonjs aware, but it can be used without them:

var datetime = new Date(2018, 03 - 1, 1, 14, 20, 31, 123);
console.log(dateFormat(datetime, "yyyy MM dd HH:mm:ss - L"));

2018 03 01 14:20:31 - 12

Masks

Initial masks were changed to stay closer to the unicode standard. Here is the table of all supported characters:

| Mask | Description | |----------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | d | Day of the month as digits; no leading zero for single-digit days | | dd | Day of the month as digits; leading zero for single-digit days | | D | Day of the year as digits; no leading zero for single-digit days | | DD | Day of the year as digits; leading zero for single-digit days | | DDD | Day of the year as digits; two leading zeroes for two-digit days | | E | Day of the week as a three-letter abbreviation | | EE | Day of the week as a three-letter abbreviation | | EEE | Day of the week as a three-letter abbreviation | | EEEE | Day of the week as its full name | | e | Day of the week as digits; no leading zero for single-digit days. Monday is 1, Sunday is 7 | | ee | Day of the week as digits; leading zero for single-digit days. Monday is 01, Sunday is 07 | | eee | Day of the week as a three-letter abbreviation | | eeee | Day of the week as its full name | | M | Month as digits; no leading zero for single-digit months | | MM | Month as digits; leading zero for single-digit months | | MMM | Month as a three-letter abbreviation | | MMMM | Month as its full name | | y | Year represented by four digits | | yy | Year as last two digits; leading zero for years less than 10 | | yyy | Year as last three digits; two leading zeroes for years less than 10 | | yyyy | Year represented by four digits | | QQQ | Quarter. Q1, Q2, Q3, Q4 | | w | Week of year as digits according to ISO 8601; no leading zero for single-digit weeks | | ww | Week of year as digits according to ISO 8601; leading zero for single-digit weeks | | h | Hours; no leading zero for single-digit hours (12-hour clock) | | hh | Hours; leading zero for single-digit hours (12-hour clock) | | H | Hours; no leading zero for single-digit hours (24-hour clock) | | HH | Hours; leading zero for single-digit hours (24-hour clock) | | m | Minutes; no leading zero for single-digit minutes | | mm | Minutes; leading zero for single-digit minutes | | s | Seconds; no leading zero for single-digit seconds | | ss | Seconds; leading zero for single-digit seconds | | l or L | Milliseconds. l gives 3 digits. L gives 2 digits | | a | AM or PM | | Z | GMT/UTC timezone offset, e.g. -0500 or +0230 | | ZZZZ | The long localized GMT format, e.g. GMT-5:00 | | S | The date's ordinal suffix (st, nd, rd, or th). Works well with d | | '…'or"…" | Literal character sequence. Surrounding quotes are removed | | UTC: | Must be the first four characters of the mask. Converts the date from local time to UTC/GMT/Zulu time before applying the mask. The "UTC:" prefix is removed |