easydatetimeformat

A lightweight node.js package for formatting Date & Time in easy way. Source File < 5kb

Installation

$ npm install easydatetimeformat

How To Use

Import Module

var { dateTimeFormat } = require("easydatetimeformat");
or
var dateTimeFormat = require("easydatetimeformat").dateTimeFormat;

Basic Format

// get default format [dd-mm-yyyy]
dateTimeFormat();
or dateTimeFormat('now');
or dateTimeFormat(new Date());
or dateTimeFormat(1622658600000);
or dateTimeFormat('03-06-2021'); //dd-mm-yyyy
or dateTimeFormat('03-06-21'); //dd-mm-yy
or dateTimeFormat('2021-06-03'); //yyyy-mm-dd
// 03-06-2021 [dd-mm-yyyy]

Get Custom Format

// get user defined format
dateTimeFormat('now', 'dd-mm-yyyy hh:ii:ss');
// 03-06-2021 23:35:04

dateTimeFormat('now', 'dd-mm-yyyy hh:ii:ss A');
or dateTimeFormat(new Date, 'dd-mm-yyyy hh:ii:ss A');
or dateTimeFormat(new Date(), 'dd-mm-yyyy hh:ii:ss A');
or dateTimeFormat(1622743639156, 'dd-mm-yyyy hh:ii:ss A');
//03-06-2021 11:37:19 PM

dateTimeFormat('12-2-2020', 'ddd MMM yyyy');  //12th Feb 2020
dateTimeFormat('12-2-20', 'ddd MMM yyyy');  //12th Feb 2020
dateTimeFormat('2020-2-12', 'ddd MMM yyyy');  //12th Feb 2020

Set Format

// input date type --> date-month-year
dateTimeFormat('02-12-2020', 'ddd MMM yyyy');  //2nd Dec 2020
dateTimeFormat('02-12-20', 'ddd MMM yyyy');  //2nd Dec 2020
dateTimeFormat('02-12-2020', 'ddd MMM yyyy', '%d%m%y');  //2nd Dec 2020
dateTimeFormat('02-12-20', 'ddd MMM yyyy', '%d%m%y');  //2nd Dec 2020


// input date type --> year-month-date
dateTimeFormat('2020-12-23', 'ddd MMMM yyyy');  // 23rd December 2020
dateTimeFormat('2020-12-23', 'ddd MMMM yyyy', '%y%m%d');  // 23rd December 2020
dateTimeFormat('20-12-23', 'ddd MMMM yyyy', '%y%m%d');  // 23rd December 2020


// input date type --> month-date-year
dateTimeFormat(new Date('02-12-2020'), 'ddd MMM yyyy')  // 12th Feb 2020
dateTimeFormat('02-12-2020', 'ddd MMM yyyy', '%m%d%y'); // 12th Feb 2020
dateTimeFormat('02-12-20', 'ddd MMM yyyy', '%m%d%y');  // 12th Feb 2020

Some Friendly Error

// input date type --> date-month-year
dateTimeFormat('53-12-2020', 'ddd MMM yyyy');  // Invalid Date
dateTimeFormat('5-13-2020', 'ddd MMM yyyy');  // Invalid Month
dateTimeFormat('5-12-20202', 'ddd MMM yyyy');  // Invalid Year
dateTimeFormat('5-12-2020-20', 'ddd MMM yyyy');  // Invalid Format
and so on...

Any Type of Date Separator [dot(.) comma(,) dash(-) slash(/) blank( ) underscore(_)]

// input date type --> date-month-year
dateTimeFormat('5.12.2020', 'ddd MMM yyyy');
or dateTimeFormat('5-12-2020', 'ddd MMM yyyy');
or dateTimeFormat('5 12 2020', 'ddd MMM yyyy');
or dateTimeFormat('5,12,2020', 'ddd MMM yyyy');
or dateTimeFormat('5/12/2020', 'ddd MMM yyyy');
or dateTimeFormat('5_12_2020', 'ddd MMM yyyy');
// 5th Dec 2020

Format Options

| Format | Format Description | |-----------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | d | Day of the month as digits; no leading zero for single-digit days. (1, .. ,31) | | dd | Day of the month as digits; leading zero for single-digit days. (01, .. ,31) | | ddd | Day of the month as ordinal number. (1st, 2nd, 3rd, 4th, .. ,31st) | | DDD | Day of the week as a three-letter abbreviation. (Sun, ... Sat) | | DDDD | Day of the week as its full name (Sunday, ... Saturday) | | m | Month as digits; no leading zero for single-digit months. (1, .. ,12) | | mm | Month as digits; leading zero for single-digit months. (01, .. ,12) | | MMM | Month as a three-letter abbreviation. (Jan, ...., Dec) | | MMMM | Month as its full name. (January, ...., December) | | yy | Year as last two digits | | yyyy | Year represented by four digits. | | h | Hours; no leading zero for single-digit hours | | hh | Hours; leading zero for single-digit hours | | i | Minutes; no leading zero for single-digit minutes. | | ii | Minutes; leading zero for single-digit minutes. | | s | Seconds; no leading zero for single-digit seconds. | | ss | Seconds; leading zero for single-digit seconds. | | A | AM or PM. |