initial import of code

Author: jsievert

LICENSE

@@ -0,0 +1,19 @@
+© 2011 by Jerry Sievert
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

lib/date-utils.js

@@ -0,0 +1,84 @@
+(function () {
+
+    var origParse = Date.parse;
+    Date.parse = function (date) {
+        var timestamp = origParse(date), minutesOffset = 0, match;
+        if (isNaN(timestamp) && (match = /^(\d{4}|[+\-]\d{6})-(\d{2})-(\d{2})(?:[T ](\d{2}):(\d{2})(?::(\d{2})(?:\.(\d{3,}))?)?(?:(Z)|([+\-])(\d{2})(?::?(\d{2}))?))?/.exec(date))) {
+            if (match[8] !== 'Z') {
+                minutesOffset = +match[10] * 60 + (+match[11]);
+                
+                if (match[9] === '+') {
+                    minutesOffset = 0 - minutesOffset;
+                }
+            }
+            
+            timestamp = Date.UTC(+match[1], +match[2] - 1, +match[3], +match[4], +match[5] + minutesOffset, +match[6], +match[7].substr(0, 3));
+        }
+        
+        return timestamp;
+    };
+
+    var months_abbr = [
+        'Jan',
+        'Feb',
+        'Mar',
+        'Apr',
+        'May',
+        'Jun',
+        'Jul',
+        'Aug',
+        'Sep',
+        'Oct',
+        'Nov',
+        'Dec'
+    ];
+    
+    if (Date.prototype.getMonthAbbr === undefined) {
+        Date.prototype.getMonthAbbr = function() {
+            return months_abbr[this.getMonth()];
+        }
+    }
+
+    var months = [
+        'January',
+        'February',
+        'March',
+        'April',
+        'May',
+        'June',
+        'July',
+        'August',
+        'September',
+        'October',
+        'November',
+        'December'
+    ];
+    
+    if (Date.prototype.getMonthName === undefined) {
+        Date.prototype.getMonthName = function() {
+            return months[this.getMonth()];
+        }
+    }
+    
+    function pad(str, length) {
+        str = String(str);
+        while (str.length < length) {
+            str = '0' + str;
+        }
+        return str;
+    }
+
+    if (Date.prototype.toCLFString === undefined) {
+        Date.prototype.toCLFString = function() {
+            var tz = pad(Math.abs(this.getTimezoneOffset() / 0.6), 4);
+            if (this.getTimezoneOffset() > 0) {
+                tz = '-' + tz;
+            }
+
+            return pad(this.getDate(), 2) + '/' + this.getMonthAbbr() + '/' + this.getFullYear() +
+                ':' + pad(this.getHours(), 2) + ':' + pad(this.getMinutes(), 2) + ':' + pad(this.getSeconds(), 2) + ' ' + tz;
+        }
+    }
+    
+    
+}());

test/date-format.js

@@ -0,0 +1,42 @@
+var vows   = require('vows');
+var assert = require('assert');
+
+require('../lib/date-utils.js');
+
+function pad(str, length) {
+    str = String(str);
+    while (str.length < length) {
+        str = '0' + str;
+    }
+    return str;
+}
+
+vows.describe('Date Format').addBatch({
+    'can return month abbreviations as object method': {
+        topic: function () { return new Date(123456789) },
+        'returns the correct abbreviated month': function (date) {
+            assert.equal(date.getMonthAbbr(), 'Jan');
+        }
+    },
+    
+    'can return month as object method': {
+        topic: function () { return new Date(123456789) },
+        'returns the correct month': function (date) {
+            assert.equal(date.getMonthAbbr(), 'Jan');
+        }
+    },
+    
+    'can return common log formatted string': {
+        topic: function () { return new Date(Date.UTC(2011, 0, 1, 1, 1, 1, 0)) },
+        'returns the correct clf string': function (date) {
+            var tz = pad(Math.abs(date.getTimezoneOffset() / 0.6), 4);
+            if (date.getTimezoneOffset() > 0) {
+                tz = '-' + tz;
+            }
+            
+            date = new Date(date.valueOf() + date.getTimezoneOffset() * 60000);
+            assert.equal(date.toCLFString(), '01/Jan/2011:01:01:01 ' + tz);
+        }
+    }
+    
+}).run();

test/date-parse.js

@@ -0,0 +1,48 @@
+var vows   = require('vows');
+var assert = require('assert');
+
+require('../lib/date-utils.js');
+
+vows.describe('Date Parse').addBatch({
+    'can instantiate milliseconds': {
+        topic: function () { return new Date(123456789) },
+        'returns a valid date object': function (date) {
+            assert.ok(date);
+        },
+        'returns a correct value': function (date) {
+            assert.equal(date.valueOf(), 123456789);
+        }
+    },
+    
+    'can instantiate string': {
+        topic: function () { return new Date('Jan 1, 2011 01:01:01 GMT') },
+        'returns a valid date object': function (date) {
+            assert.ok(date);
+        },
+        'returns a correct value': function (date) {
+            assert.equal(date.valueOf(), 1293843661000);
+        }
+    },
+    
+    'can instantiate arguments': {
+        topic: function () { return new Date(2011, 1, 1, 1, 1, 1, 0) },
+        'returns a valid date object': function (date) {
+            assert.ok(date);
+        }
+    },
+    
+    'can parse normal date': {
+        topic: function () { return Date.parse('Jan 1, 2011 01:01:01 GMT') },
+        'returns a correct value': function (milli) {
+            assert.equal(milli, 1293843661000);
+        }
+    },
+    
+    'can parse ISO-8601': {
+        topic: function () { return Date.parse('2011-01-01T01:01:01Z') },
+        'returns a correct value': function (milli) {
+            assert.equal(milli, 1293843661000);
+        }
+    }
+    
+}).run();