d8

d8 is a date parsing and formatting micro-framework for modern JavaScript engines.

d8.js

d8 is a date parsing and formatting micro-framework for modern JavaScript engines.

d8 uses Templ8 to output a String representation of a Date, based on php formatting options.

As d8 extends JavaScript's native Date & Date.prototype – the CORRECT way – there is no actual global called d8. Instead all static and instance methods are available from the native Date & Date.prototype respectively.

currently the only locales available are:

  • en-GB
  • en-US

but feel free to create a locale for your specific nationality and submit a pull request! :D

This is an, as yet, untested and incompletely documented framework. Use at your own risk.

 
<!-- IMPORTANT: Templ8 must be loaded before d8 -->
   <script src="/path/to/Templ8/Templ8.client.min.js" type="text/javascript"></script> 
<!-- IMPORTANT: The correct locale must ALSO be loaded before d8! -->
   <script src="/path/to/d8/locale/en-GB.js" type="text/javascript"></script> 
   <script src="/path/to/d8/d8.min.js" type="text/javascript"></script> 
 
 
   require( 'd8/locale/en-GB.js' ); // IMPORTANT: The correct locale must ALSO be loaded before d8!! 
   require( 'd8' );
 

As mentioned above d8 extends JavaScript's native Date & Date.prototype, so when requiring d8, you don't need to assign it to a variable to use d8's features.

An Object of all the available filters for formatting a Date.

An Object containing some default date formats:

ISO_8601Y-m-dH:i:sP
ISO_8601_SHORTY-m-d
RFC_850l, d-M-y H:i:s T
RFC_2822D, d M Y H:i:s O
sortableY-m-d H:i:sO
dDay of the month, 2 digits with leading zeros
DA textual representation of a day, three letters
jDay of the month without leading zeros
lA full textual representation of the day of the week
NISO-8601 numeric representation of the day of the week
SEnglish ordinal suffix for the day of the month, 2 characters
wNumeric representation of the day of the week
zThe day of the year (starting from 0)
### week
WISO-8601 week number of year, weeks starting on Monday
### month
FA full textual representation of a month
mNumeric representation of a month, with leading zeros
MA short textual representation of a month, three letters
nNumeric representation of a month, without leading zeros
tNumber of days in the given month
### year
LWhether it's a leap year
oISO-8601 year number. This has the same value as Y, except that if the ISO week number (W) belongs to the previous or next year, that year is used instead.
YA full numeric representation of a year, 4 digits
yA two digit representation of a year
### time
aLowercase Ante meridiem and Post meridiem
AUppercase Ante meridiem and Post meridiem
g12-hour format of an hour without leading zeros
G24-hour format of an hour without leading zeros
h12-hour format of an hour with leading zeros
H24-hour format of an hour with leading zeros
iMinutes with leading zeros
sSeconds, with leading zeros
uMilliseconds
### timezone
ODifference to Greenwich time (GMT) in hours
PDifference to Greenwich time (GMT) with colon between hours and minutes
TTimezone abbreviation
ZTimezone offset in seconds. The offset for timezones west of UTC is always negative, and for those east of UTC is always positive.
### full date/time
cISO 8601 date
rRFC 2822 formatted date
USeconds since the Unix Epoch January 1 1970 00:00:00 GMT