Time for a new Date()

Introducing a new Date library, Tempus (http://tempus-js.com)

Transcript

1. Hi
2. Keith Cirkel @keithamus github/keithamus
4. new Date()
5. new ProblemBro()
6. new ProblemBro
7. Why is Date() crap?
8. • Odd quirks • Awkward Syntax • Special behaviours • Lacking in functionality
9. Odd Quirks
10. d.setFullYear(2012); d.getYear() -> 112
12. Awkward Syntax
13. d = new Date() d.getFullYear() + '-' + d.getMonth() + '-' + d.getDate() + ' ' + d.getHours() + ':' + d.getMinutes() + ':' + d.getSeconds(); -> "2012-1-22 11:27:27"
15. Special Behaviours
16. // valueOf(); Number(new Date()); 1329910810336 // toString(); String(new Date()); "Wed Feb 22 2012 11:38:17 GMT+0000 (GMT)"
17. // valueOf(); + new Date(); 1329910810336 // toString(); '' + new Date(); "Wed Feb 22 2012 11:38:17 GMT+0000 (GMT)"
18. // valueOf(); Number(new MyClass()); 1 // toString(); String(new MyClass()); "FOO"
19. // valueOf(); + new MyClass(); 1 // valueOf(); '' + new MyClass(); "1"
20. “When the [[DefaultValue]] internal method of O is called with no hint, then it behaves as if the hint were Number, unless O is a Date object (see 15.9.6), in which case it behaves as if the hint were String.” es5.github.com/x8.html#x8.12.8
22. Lacking in functionality
23. Python • Short accessors: date.year • Good ISO8601 support • strftime formatting • ‘naive dates’ (timezones) • iterators, calendar class, assertions, ranges
24. PHP • DateTime class • OK ISO8601 support • strftime formatting • format constants (RSS, W3C) • date math, timezones
25. Java • Lots of classes for stu! • SimpleDateFormat strings • Assertions (equals, after... ) • timezone support
26. Ruby • Short accessors: date.year • Great ISO/RFC support • strftime • timezones, locales
27. Time for a new Date()
28. Good Library Rules • Small when gzipped (<5kb) • Good documentation • Terse code internal & ext. • Good patterns (chaining) • Good browser support • Cross JS code, browser/Node
29. Steal the Good Parts • Common language features • ISO8601 Support • strftime support • short accessors • timezone support • assertions (equalTo, lessThan)
31. Tempus
32. Object.getOwnPropertyNames( Date.prototype ).length -> 47 Object.getOwnPropertyNames( Tempus.prototype ).length -> 217
33. Short, chainable setters and getters
34. d = new Tempus() d.date() -> 22 d.clone().date(13).toString() -> "Mon Feb 13 2012 12:25:46 +0000"
35. Full Compatibility with Date() (almost)
36. d = new Tempus() d.getYear() -> 12 d.getYear(13).getFullYear() -> 2013 d.setFullYear(1980).year() -> 80 Fix *Year()
37. Assertions = true
38. d = new Tempus() d.isLeapYear() -> true d.isDST() -> false d.isBefore( 2012, 1, 23 ) -> true
39. ISO/RFC & strftime
40. d = new Tempus("2012-02-22T12:35:25.519+0000"); d = new Tempus("2012-02-22T12:35:25+00:00"); d = new Tempus("Wed, 22 Feb 2012 12:35:25 +0000"); d = new Tempus("Wed, 22 Feb 2012 12:35:25 GMT"); d.toISO8601String(); /* or */ d.toString("ISO8601"); -> "2012-02-22T12:35:25.519+0000" d.toW3CString() /* or */ d.toString("W3C"); -> "2012-02-22T12:35:25+00:00" /* So many more too */
41. d = new Tempus(); d.toString("%d%o %B %Y, (%r) ") -> "22nd February 2012, (12:35:25 PM)"
42. Now for the really cool bit
43. d = new Tempus( "22nd February 2012, (12:35:25 PM)" "%d%o %B %Y, (%r) " ); // Arrays! d = new Tempus( "2012/02/22" ["%Y/%m/%d", "%d/%m/%Y"] );
44. Timezones
45. d = new Tempus(); d.toString("%I:%m%p") -> 12:02pm d.timezone("+04:00") d.toString("%I:%m%p") -> 04:02pm
46. Iterators
47. new Tempus().eachDayOfMonth( function () { console.log(arguments); } ); -> 1 [Tempus Instance - 1st Feb] -> 2 [Tempus Instance - 2nd Feb] -> 3 [Tempus Instance - 3rd Feb] ... -> 29 [Tempus Instance - 29th Feb]
48. When Can I Get It?
49. 0.1 (yes, an alpha version) 4.5kb minzipped MIT License tempus-js.com
50. I need your help Lets make it awesome together!
51. I need your help Lets make it awesome together!
52. Questions?