Prototype ¬ Detail

author: alex_tea [+], Submitted: 04.24.04 11a • Last Edit: 04.24.04 11a
Avg. Rating: 4

Date.prototype.formatDate = function(format) {
    var amPmLower, amPmUpper, swatchBeats, isoDate, datePad, dayWordShort, monthWordFull, hours12, hours24, hours12Pad, hours24Pad, minutes, dayLight, dateNum, dayWordFull, leapYear, monthPad, monthWordShort, monthNum, gmtOffset, rfcDate, seconds, suffix, monthLength, timeZone, unixTime, dayNum, firstDay, weekNum, smallYear, fulYear, dayOfYear, tZOffset;

    var fullDays = [ "Sunday", "Monday", "Tuesday", "Wednesday", "Thursday", "Friday", "Saturday" ]
    var fullMonths = [ "January", "February", "March", "April", "May", "June", "July", "August", "September", "October", "November", "December" ]
    var dateSuffix = [ "th", "st", "nd", "rd" ]
    
    var keys = [ "a", "A", "B", "c", "d", "D", "F", "g", "G", "h", "H", "i", "I", "j", "l", "L", "m", "M", "n", "O", "r", "s", "S", "t", "T", "U", "w", "W", "y", "Y", "z", "Z" ];
    var values = [ "amPmLower", "amPmUpper", "swatchBeats", "isoDate", "datePad", "dayWordShort", "monthWordFull", "hours12", "hours24", "hours12Pad", "hours24Pad", "minutes", "dayLight", "dateNum", "dayWordFull", "leapYear", "monthPad", "monthWordShort", "monthNum", "gmtOffset", "rfcDate", "seconds", "suffix", "monthLength", "timeZone", "unixTime", "dayNum", "weekNum", "smallYear", "fullYear", "dayOfYear", "tZOffset"];
    
    // Hours Minutes Seconds
    hours24         = this.getHours();
    hours12         = (hours24 == 0) ? 12 : ((hours24 < 12) ? hours24 : (hours24) - 12);
    hours24Pad      = hours24.pad(2);
    hours12Pad      = hours12.pad(2);
    minutes         = this.getMinutes().pad(2);
    seconds         = this.getSeconds().pad(2);
    
    // Day Month Year
    dateNum         = this.getDate();
    datePad         = dateNum.pad(2);
    dayNum          = this.getDay();
    monthNum        = this.getMonth() + 1;
    monthPad        = monthNum.pad(2);
    fullYear        = this.getFullYear();
    smallYear       = String(fullYear).slice(-2);
    monthLength     = new Date(fullYear, monthNum+1, 0).getDate();
    leapYear        = ((fullYear % 4 == 0) && ((fullYear % 100 != 0) || (fullYear % 400 == 0))) ? 1 : 0;
    
    // Written equivalents
    amPmLower       = (hours24 > 12) ? "pm" : "am";
    amPmUpper       = amPmLower.toUpperCase();
    dayWordFull     = fullDays[dayNum];
    monthWordFull   = fullMonths[monthNum-1];
    dayWordShort    = dayWordFull.slice(0, 3);
    monthWordShort  = monthWordFull.slice(0, 3);
    suffix          = (dateNum % 10 > 3) ? dateSuffix[0] : dateSuffix[dateNum % 10];
    
    // Miscellaneous
    swatchBeats     = Math.floor((((((this.getUTCHours()+1) * 60) + this.getUTCMinutes()) * 60) + this.getUTCSeconds()) /  86.4);
    unixTime        = Math.round(this.getTime() / 1000);
    tZOffset        = this.getTimezoneOffset() * 60;
    gmtOffset       = ((-tZOffset >= 0) ? "+" : "-") + (Math.floor((Math.abs(tZOffset) / 60) / 60) * 100).pad(4);
    dayLight        = (this.getTimeZoneOffset() < new Date(fullYear, monthNum - 6).getTimeZoneOffset()) ? 1 : 0;
    
    // WeekNumber
    firstDay        = new Date(fullYear, 0, 1);
    weekNum         = Math.round((((this.getTime() - (firstDay.getTime())) / 86400000) + ((firstDay.getDay() > 3) ? -4 : 3)) / 7);
    dayOfYear       = Math.floor((this.getTime() - firstDay.getTime()) / 86400000);
    
    // Formated Strings
    rfcDate         = dayWordShort+", "+dateNum+" "+monthWordFull+" "+fullYear+" "+hours24Pad+":"+minutes+":"+seconds+" "+gmtOffset;
    isoDate         = fullYear+"-"+monthPad+"-"+datePad+"T"+hours24Pad+":"+minutes+":"+seconds+gmtOffset;
    
    for (var i=0; i<keys.length; i++) {
        trace(keys[i]+": "+values[i]+": "+eval(values[i]));
    }
    
    var output, found;

    for (var i=0; i<format.length; i++) {
        found = false;
        for (var j=0; j<keys.length; j++) {
            if (format.charAt(i) === keys[j]) {
                found = true;
                output += eval(values[j]);
                break;
            }
        }
        
        if (!found)
            output += format.charAt(i);
    }
    return output;
}

usage

PHP like Date formatting for Flash MX / Actionscript 1.0

Detailed instructions at http://home.r107.co.uk/blog/archives/000252.php

Requires my Number.pad() function to work http://proto.layer51.com/d.aspx?f=1229

Returns a formatted string representation of the date object.
Works very similarly to PHP's Date function (http://www.php.net/Date)
although there are some limitations. Escaping characters with a
backslash doesn't work and there is no support for returning the current
timezone (T). If anyone has any suggestions or fixes please let me know.

Examples:
// Prints something like: Wednesday
now = new Date();
trace(now.formatDate("l"));

// Prints something like: Wednesday 15th of January 2003 05:51:38 AM
trace(now.formatDate("l dS of F Y h:i:s A"));

// Escaping characters with backslashes does not currently work, if you want to
// create complex strings concatenation is recommended.

// Prints: July 1, 2000 is on a Saturday
firstJuly = new Date(2000, 6, 1);
trace(firstJuly.formatDate("F j, Y")+" is on a "+firstJuly.formatDate("l"));

// Some examples of formatDate() in use. Any characters which match will be interpreted
// which could cause undesirable results. Concatenate strings and results to form complex
// sentences.

// Assuming today is: April 23rd, 2004, 5:50:27 pm
today = new Date();
trace(today.formatDate("F j, Y, g:i a"));                 // April 23, 2004, 5:50 pm
trace(today.formatDate("m.d.y"));                         // 04.23.04
trace(today.formatDate("j, n, Y"));                       // 23, 4, 2004
trace(today.formatDate("Ymd"));                           // 20040423
trace(today.formatDate('h-i-s, j-m-y, it is w Day z '));  // 05-50-27, 23-04-04, 5031 5027 5 Fripm04
trace("It is the "+today.formatDate("jS")+" day");        // It is the 23rd day.
trace(today.formatDate("D M j G:i:s T Y"));               // Fri Apr 23 17:50:27  2004
trace(today.formatDate("H:i:s"));                         // 17:50:27