date.js – missing methods
Summary
Save yourself a lot of pain and ensure you’re using the right version of Datejs.
Datejs – It’s great !
Let me start by saying that Datejs, an open-source JavaScript Date Library, is great ! It provides a lot of much needed functionality to the area of dates in Javascript.
Weirdly missing methods
Having said that what I want to highlight is that if you use the standard download links offered by the website (as shown below) you’ll get a version of Datejs which is not the most current one.
What’s more it seems that the version you will get contains a number of defects.
I can vouch for this as I’ve spent a couple of hours today wondering why the ‘.isAfter’ and the ‘.compare’ methods didn’t seem to exist in the form they are documented ! Very frustrating !
What You Should Do
Instead of using the download link on the first page to get the date.js file go here instead : http://www.datejs.com/build/date.js. The version number is the same, “1.0 Alpha-1”, but the build date is “2008-05-13”.
At least at the time of writing – it’s the “2008-05-13” build you want.
Credit Where Credits Due
I’m grateful to Ben McIntyre whose post on the Datejs forums alerted me to this problem, I only wish I’d seen it earlier !