dateify
v1.1.1
Published
Lightweight javascript date/time library
Downloads
2
Readme
#Dateify-js
###Lightweight date and time library for JavaScript.
Offers functions for dealing with dates and times in the browser. This library is not necessarily meant as an alternative to moment.js, more that its small as possible while still meeting my needs.
##API
###dateify
dateify :: String -> Date
dateify :: Number -> Date
dateify :: Date -> Date
dateify :: [Number] -> Date
Converts parameters into a Date object. Can take any of the parameters that the JavaScript Date constructor will accept with a few additions: a subset of ISO 8601 formatted datestrings can be parsed, and it can take an array of Numbers and spread them for the constructor.
###deDateify
deDateify :: Date -> String
Converts a Date object into an ISO 8601 datestring.
###isLeapYear
isLeapYear :: Number -> Boolean
Will correctly identify whether or not any CE year is a leap year. Does not work for BCE years.
###toUTCDateString
toUTCDateString :: Date -> String
Same as deDateify but outputs a zulu time string.
###destructure
destructure :: Date -> [Number]
Performs the reverse operation of the Date constructor: takes a Date and returns an array of its
numbers [yr, mon*, day, hr, min, sec]
, same position as the Date constructor takes them.
* Does not add 1 to the month, i.e. January is 0.
##Input Upgrades
Because not all browsers implement input type='date/time' dateify provides some functions to implement some basic validation/formatting on the passed-in input elements. Note that calling the function without an input argument will cause one to be created of the appropriate tag. Because I use Polymer frequently, I've added versions of these that work for paper-inputs:
###toDateInput
###toTimeInput
###toPaperDate
###toPaperTime
All have a signature of HTMLElement -> HTMLElement
or Nil -> HTMLElement
.
##NOTE
-When used with Polymer paper-inputs
:
Polymer paper inputs will not behave correctly in chrome unless you declare the type attribute to be
date before the element is completely upgraded (e.g. 'dom-change' event fired on an auto-binding
template). If using with Polymer make sure to set type="date"
in your markup (won't affect other
browsers).