Method Date.format

Format a date

• Syntax String Date.format(String format , [ Boolean UTC ])
  
  Formats a date according to the format string provided. If UTC is not true then the local time is used. This function is modeled to mimic the PHP date function.
• Parameters

  String format

  The following characters are recognized in the input string

  Day
  d	Day of the month, 2 digits with leading zeros
  D	A textual representation of a day, three letters
  j	Day of the month without leading zeros
  l	A full textual representation of the day of the week
  N	ISO-8601 numeric representation of the day of the week
  S	English ordinal suffix for the day of the month, 2 characters
  w	Numeric representation of the day of the week (sunday=0)
  z	The day of the year (starting from 0) N/A
  Week
  W	ISO-8601 week number of year, weeks starting on Monday
  Month
  F	A full textual representation of a month, such as January or March
  m	Numeric representation of a month, with leading zeros
  M	A short textual representation of a month, three letters
  n	Numeric representation of a month, without leading zeros
  t	Number of days in the given month
  Year
  L	Whether it\'s a leap year 1 if it is a leap year, 0 otherwise
  Y	A full numeric representation of a year, 4 digits
  y	A two digit representation of a year
  Time
  a	Lowercase Ante meridiem and Post meridiem (am or pm)
  A	Uppercase Ante meridiem and Post meridiem (AM or PM)
  g	12-hour format of an hour without leading zeros 1 through 12
  G	24-hour format of an hour without leading zeros 0 through 23
  h	12-hour format of an hour with leading zeros 01 through 12
  H	24-hour format of an hour with leading zeros 00 through 23
  i	Minutes with leading zeros 00 to 59
  s	s Seconds, with leading zeros 00 through 59
  u	Milliseconds
  Timezone
  e	Timezone identifier (Examples: UTC, GMT, Atlantic/Azores) N/A
  I	Whether or not the date is in daylight saving time 1 if Daylight Saving Time, 0 otherwise.
  O	Difference to Greenwich time (GMT) in hours
  P	Difference to Greenwich time (GMT) with colon between hours and minutes
  T	Timezone abbreviation:n/a\n
  Z	Timezone offset in seconds. The offset for timezones west of UTC is always negative, and for those east of UTC is always positive.
  Full date/time
  c	ISO 8601 date
  r	RFC 2822 formatted date
  U	Seconds since the Unix Epoch

  Boolean UTC (Optional)

  If true UTC is used; otherwise the local time is used.

• Return value A string representation of the date as specified by format.
• Examples

  To format a date in a nice human readable manner

  // Create date - 1/2/2010 at half past midday
  var d = new Date(2010,1,1,12,30);
  // Output '12:30 on 1st of February 2010'
  d.format('H:i') + ' on ' + d.format('jS') + ' of ' + d.format('F Y');

• Download
  Download this function including dependencies
  Source

  Unless otherwise noted all code in the JSLab Standard Library is licensed as GPLv3. See http://www.gnu.org/licenses/gpl.html for the entire license.

  This function has dependencies and will not work stand-alone. Use the download button above instead of copy/paste.

  // ************************************************************************** // Copyright 2007 - 2009 Tavs Dokkedahl // Contact: http://www.jslab.dk/contact.php // // This file is part of the JSLab Standard Library (JSL) Program. // // JSL is free software; you can redistribute it and/or modify // it under the terms of the GNU General Public License as published by // the Free Software Foundation; either version 3 of the License, or // any later version. // // JSL is distributed in the hope that it will be useful, // but WITHOUT ANY WARRANTY; without even the implied warranty of // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the // GNU General Public License for more details. // // You should have received a copy of the GNU General Public License // along with this program. If not, see <http://www.gnu.org/licenses/>. // *************************************************************************** // Format a date according to a specified format Date.prototype.format = function(s,utc) { // Split into array s = s.split(''); var l = s.length; var r = ''; var n = m = null; for (var i=0; i<l; i++) { switch(s[i]) { // Day of the month, 2 digits with leading zeros: 01 to 31 case 'd': n = utc ? this.getUTCDate() : this.getDate(); if (n * 1 < 10) r += '0'; r += n; break; // A textual representation of a day, three letters: Mon through Sun case 'D': r += this.getNameOfDay(utc).substring(0,3); break; // Day of the month without leading zeros: 1 to 31 case 'j': r += utc ? this.getUTCDate() : this.getDate(); break; // Lowercase l A full textual representation of the day of the week: Sunday (0) through Saturday (6) case 'l': r += this.getNameOfDay(utc); break; // ISO-8601 numeric representation of the day of the week: 1 (for Monday) through 7 (for Sunday) case 'N': r += this.getISODay(utc); break; // English ordinal suffix for the day of the month, 2 characters case 'S': r += this.getDaySuffix(utc); break; // Numeric representation of the day of the week: 0 (for Sunday) through 6 (for Saturday) case 'w': r += utc ? this.getUTCDay() : this.getDay(); break; // The day of the year (starting from 0) 0 through 365 case 'z': n = 0; m = utc ? this.getUTCMonth() : this.getMonth(); for(var i=0; i<m; i++) n += Date.daysInMonth[i] if (this.isLeapYear()) n++; n += utc ? this.getUTCDate() : this.getDate(); n--; r += n; break; // break; // ISO-8601 week number of year, weeks starting on Monday case 'W': r += this.getISOWeek(utc); break; // A full textual representation of a month, such as January or March: January through December case 'F': r += this.getNameOfMonth(utc); break; // Numeric representation of a month, with leading zeros 01 through 12 case 'm': n = utc ? this.getUTCMonth() : this.getMonth(); n++; if (n < 10) r += '0'; r += n; break; // A short textual representation of a month, three letters: Jan through Dec case 'M': r += this.getNameOfMonth(utc).substring(0,3); break; // Numeric representation of a month, without leading zeros: 1 through 12 case 'n': n = utc ? this.getUTCMonth() : this.getMonth(); r += ++n; break; // Number of days in the given month: 28 through 31 case 't': r += this.getDaysInMonth(utc); break; // Whether it's a leap year: 1 if it is a leap year, 0 otherwise. case 'L': if (this.isLeapYear(utc)) r += '1'; else r += '0'; break; // ISO-8601 year number. This has the same value as Y, except that if the ISO week number (W) belongs to the previous or next year, that year is used instead /* case 'o': break; */ // A full numeric representation of a year, 4 digits case 'Y': r += utc ? this.getUTCFullYear() : this.getFullYear(); break; // A two digit representation of a year case 'y': n = utc ? this.getUTCFullYear() : this.getFullYear(); r += (n + '').substring(2); break; // Lowercase Ante meridiem and Post meridiem am or pm case 'a': n = utc ? this.getUTCHours() : this.getHours(); r += n < 12 ? 'am' : 'pm'; break; // Uppercase Ante meridiem and Post meridiem AM or PM case 'A': n = utc ? this.getUTCHours() : this.getHours(); r += n < 12 ? 'AM' : 'PM'; break; // Swatch Internet time 000 through 999 // case 'B': // break; // 12-hour format of an hour without leading zeros case 'g': n = utc ? this.getUTCHours() : this.getHours(); if (n > 12) n -= 12; r += n; break; // 24-hour format of an hour without leading zeros 0 through 23 case 'G': r += this.getHours(); break; // 12-hour format of an hour with leading zeros 01 through 12 case 'h': n = utc ? this.getUTCHours() : this.getHours(); if (n > 12) n -= 12; if (n < 10) r += '0'; r += n; break; // 24-hour format of an hour with leading zeros 00 through 23 case 'H': n = utc ? this.getUTCHours() : this.getHours(); if (n < 10) r += '0'; r += n; break; // i Minutes with leading zeros 00 to 59 case 'i': n = utc ? this.getUTCMinutes() : this.getMinutes(); if (n < 10) r += '0'; r += n; break; // s Seconds, with leading zeros 00 through 59 case 's': n = utc ? this.getUTCSeconds() : this.getSeconds(); if (n < 10) r += '0'; r += n; break; // Milliseconds case 'u': r += utc ? this.getUTCMilliseconds() : this.getMilliseconds(); break; // Timezone identifier // case 'e': // break; // Whether or not the date is in daylight saving time 1 if Daylight Saving Time, 0 otherwise. case 'I': if (this.getMinutes() != this.getUTCMinutes) r += '1'; else r += '0'; break; // Difference to Greenwich time (GMT) in hours case 'O': n = this.getTimezoneOffset() / 60; if (n >= 0) r += '+'; else r += '-'; n = Math.abs(n); if (Math.abs(n) < 10) r += '0'; r += n + '00'; break; // Difference to Greenwich time (GMT) with colon between hours and minutes: Example: +02:00 case 'P': n = this.getTimezoneOffset() / 60; if (n >= 0) r += '+'; else r += '-'; n = Math.abs(n); if (Math.abs(n) < 10) r += '0'; r += n + ':00'; break; // T Timezone abbreviation EST, MDT etc. // case 'T': // break; // Z Timezone offset in seconds. The offset for timezones west of UTC is always negative, and for those east of UTC is always positive. case 'Z': r += this.getTimezoneOffset() * 60; break; // ISO 8601 date: 2004-02-12T15:19:21+00:00 case 'c': r += this.format('Y-m-d',utc) + 'T' + this.format('H:i:sP',utc); break; // RFC 2822 formatted date Example: Thu, 21 Dec 2000 16:01:07 +0200 case 'r': r += this.format('D, j M Y H:i:s P',utc); break; case 'U': r += this.getTime(); break; default: r += s[i]; } } return r };