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

WARNING!

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

browser usage

<!-- 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>

nodejs usage

   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.

API

Static methods

isLeapYear( year:String ):Boolean

setLeapYear( date:Date ):Void

toDate( date:String, format:String ):Date

Static properties

filters

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

formats

An Object containing some default date formats:

Instance methods

GMTOffset( colon:Boolean ):String

ISODay():Number

ISODaysInYear():Number

ISOFirstMondayOfYear():Date

ISOWeek():Number

ISOWeeksInYear():Number

adjust( interval:Object|String, value:Number ):Date

between( date_lower:Date, date_higher:Date ):Boolean

clearTime():Date

clone():Date

dayOfYear():Number

firstOfTheMonth():Date

format( format:String ):String

isDST():Boolean

isLeapYear():Boolean

lastOfTheMonth():Date

timezone():String

Date formatting and parsing options

day