daylight

daylight

I absolutely love the moment.js library, but at times it runs a bit heavier than I really need. I like the simplicity of PHP's built-in date() function and wrote this to be sort of similar.

usage

note: daylight does a rather rudimentary job parsing dates (strings are just passed through Date.parse()), so beware of local timezone vs utc time-string pitfalls.

in the browser

TODO: requirejs, commonjs, etc. module support

<script src="daylight.js"></script>
<script>
    var today = daylight('l, F jS', Date.now());
    var p = document.createElement('p');
    p.innerText = today;
    document.body.appendChild(p);

    //=> <p>Wednesday, May 28th</p>
</script>

using node

install with npm install daylight, run tests with npm test, etc.

var daylight = require('daylight');
console.log(daylight('l, F jS', Date.now()));

//=> Wednesday, May 28th

format strings

these are copied from php's date() function

characters not on this list are passed normally; to escape characters you'll have to use double backslashes:

var today = daylight('\\d\\a\\y: l', Date.now());
console.log(today);
//=> day: Wednesday

string	format	example
d	day of month, with leading zero	01 to 31
D	day of week, three letter abbreviation	Sun to Sat
j	day of month, without leading zero	1 to 31
l (lower-case L)	day of week, full word	Sunday to Saturday
N	numeric day of the week	1 to 7
S	English suffix	st, nd, rd, th
w	zero-based day of the week	0 (Sunday) to 6
z	numeric day of the year	1-366
F	month, full word	January to December
m	month with leading zero	1 to 12
M	month, three letter abbreviation	Jan to Dec
n	month without leading zero	1 to 12
Y	four-digit year	1989 or 2014
y	two-digit year	89 or 14
a	lowercase ante or post meridiem	am or pm
A	uppercase ante or post meridiem	AM or PM
g	12-hour format, no leading zero	1 to 12
G	24-hour format, no leading zero	0 to 23
h	12-hour format, leading zero	01 to 12
H	24-hour format, leading zero	00 to 23
i	minutes, with leading zero	00 to 59
s	seconds, with leading zero	00 to 59