epoch-time-machine
v1.0.4
Published
Javascript date formatter with add and subtract date and time options
Downloads
24
Maintainers
Readme
Javascript date and time formatter with add and subtract date and time functions
epoch-time-machine adds the following functions to the JavaScript Date object:
node.js: require("epoch-time-machine");
epoch
Date.toATOM() - Convert to ATOM string format: 2005-08-15T15:52:01+00:00
Date.toISO8601() - Convert to ISO8601 string format: 2005-08-15T15:52:01+0000
Date.toRFC850() - Convert to RFC850 string format: Monday, 15-Aug-05 15:52:01 UTC
Date.toRFC1036() - Convert to RFC1036 string format: Mon, 15 Aug 05 15:52:01 +0000
Date.toRSS() - Convert to RSS, RFC2822 or RFC1123 string format: Mon, 15 Aug 2005 15:52:01 +0000
Date.toW3C() - Convert to W3C string format: 2005-08-15T15:52:01+00:00
Date.toMySQL() - Convert to MySQL time stamp string format: 2005-08-15 15:52:01
Date.toFormal_date_long() - Convert to formal grammar long date: Thursday, September 22, 2016
Date.toFormal_dateTime_long() - Convert to formal grammar long date & time: Thursday, September 22, 2016, at 5:04pm
Date.toFormal_date_abbr() - Convert to formal grammar abbrivated date: Thu., Sep. 22, 2016
Date.toFormal_dateTime_abbr() - Convert to formal grammar abbrivated date & time: Thu., Sep. 22, 2016, at 5:04pm
Date.toCustomFormat() - Convert to a user specified format using the following flags:
Example
var a = new Date();
a.toCustomFormat("D., M. j, Y, \\a\\t g:ia"); //"Mon., Sep. 26, 2016, at 4:13pm"##Format Flags
\\ Escapes next character in string
###Day
dDay of the month, 2 digits with leading zeros. Example: 01 to 31jDay of the month without leading zeros. Example: 1 to 31DA textual representation of a day, three letters. Example: Mon. through Sun.lA full textual representation of the day of the week. Example: Monday through Sunday
###Month
FA full textual representation of a month, such as January or MarchMA short textual representation of a month, three letters. Example: Jan. through Dec.mNumeric representation of a month, with leading zeros. Example: 01 through 12nNumeric representation of a month, without leading zeros. Example: 1 through 12
###Year
YA full numeric representation of a year, 4 digits. Example: 1999 or 2003yA two digit representation of a year. Example: 99 or 03
###Time
aLowercase Ante meridiem and Post meridiem. Example: am or pmAUppercase Ante meridiem and Post meridiem. Example: AM or PMg12-hour format of an hour without leading zeros. Example: 1 through 12G24-hour format of an hour without leading zeros. Example: 0 through 23h12-hour format of an hour with leading zeros. Example: 01 through 12H24-hour format of an hour with leading zeros. Example: 00 through 23iMinutes with leading zeros. Example: 00 to 59sSeconds, with leading zeros. Example: 00 through 59
###Timezone
eTimezone identifier. Example: UTC, GMT, Atlantic/AzoresODifference to Greenwich time (GMT) in hours. Example: +0200PDifference to Greenwich time (GMT) with colon between hours and minutes. Example: +02:00TTimezone abbreviation. Example: EST, MDT ...
#Time Machine
Add or subtract years, months, days, hours, minutes or seconds using the following functions:
Date.addYears (number)Date.subtractYears (number)Date.addMonths (number)Date.subtractMonths (number)Date.addDays (number)Date.subtractDays (number)Date.addHours (number)Date.subtractHours (number)Date.addMinutes (number)Date.subtractMinutes (number)Date.addSeconds (number)Date.subtractSeconds (number)
Example
var a = new Date(); //Thu Sep 22 2016 17:04:50 GMT-0400 (EDT)
a.addYears(5); //Wed Sep 22 2021 17:04:50 GMT-0400 (EDT)