Properties Methods Events Direct Link

Class Date

Package:Global
Defined In:Date.js
Class:Date
Extends:Object
The date parsing and format syntax is a subset of PHP's date() function, and the formats that are supported will provide results equivalent to their PHP versions. Following is the list of all currently supported formats:
Format  Description                                                             Example returned values
------  ----------------------------------------------------------------------  -----------------------
  d     Day of the month, 2 digits with leading zeros                           01 to 31
  D     A textual representation of a day, three letters                        Mon to Sun
  j     Day of the month without leading zeros                                  1 to 31
  l     A full textual representation of the day of the week                    Sunday to Saturday
  S     English ordinal suffix for the day of the month, 2 characters           st, nd, rd or th. Works well with j
  w     Numeric representation of the day of the week                           0 (for Sunday) to 6 (for Saturday)
  z     The day of the year (starting from 0)                                   0 to 364 (365 in leap years)
  W     ISO-8601 week number of year, weeks starting on Monday                  1 to 53
  F     A full textual representation of a month, such as January or March      January to December
  m     Numeric representation of a month, with leading zeros                   01 to 12
  M     A short textual representation of a month, three letters                Jan to Dec
  n     Numeric representation of a month, without leading zeros                1 to 12
  t     Number of days in the given month                                       28 to 31
  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                       Examples: 1999 or 2003
  y     A two digit representation of a year                                    Examples: 99 or 03
  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 to 12
  G     24-hour format of an hour without leading zeros                         0 to 23
  h     12-hour format of an hour with leading zeros                            01 to 12
  H     24-hour format of an hour with leading zeros                            00 to 23
  i     Minutes, with leading zeros                                             00 to 59
  s     Seconds, with leading zeros                                             00 to 59
  u     Milliseconds, with leading zeros                                        001 to 999
  O     Difference to Greenwich time (GMT) in hours                             Example: +0200
  T     Timezone abbreviation of the machine running the code                   Examples: EST, MDT ...
  Z     Timezone offset in seconds (negative if west of UTC, positive if east)  -43200 to 50400
Example usage (note that you must escape format specifiers with '\\' to render them as character literals):
// Sample date:
// 'Wed Jan 10 2007 15:05:01 GMT-0600 (Central Standard Time)'

var dt = new Date('1/10/2007 03:05:01 PM GMT-0600');
document.write(dt.format('Y-m-d'));                         //2007-01-10
document.write(dt.format('F j, Y, g:i a'));                 //January 10, 2007, 3:05 pm
document.write(dt.format('l, \\t\\he dS of F Y h:i:s A'));  //Wednesday, the 10th of January 2007 03:05:01 PM
Here are some standard date/time patterns that you might find helpful. They are not part of the source of Date.js, but to use them you can simply copy this block of code into any script that is included after Date.js and they will also become globally available on the Date object. Feel free to add or remove patterns as needed in your code.
Date.patterns = {
    ISO8601Long:"Y-m-d H:i:s",
    ISO8601Short:"Y-m-d",
    ShortDate: "n/j/Y",
    LongDate: "l, F d, Y",
    FullDateTime: "l, F d, Y g:i:s A",
    MonthDay: "F d",
    ShortTime: "g:i A",
    LongTime: "g:i:s A",
    SortableDateTime: "Y-m-d\\TH:i:s",
    UniversalSortableDateTime: "Y-m-d H:i:sO",
    YearMonth: "F, Y"
};
Example usage:
var dt = new Date();
document.write(dt.format(Date.patterns.ShortDate));

Public Properties

Property Defined By
  Date.DAY : String
<static> Date interval constant
Date
  Date.HOUR : String
<static> Date interval constant
Date
  Date.MILLI : String
<static> Date interval constant
Date
  Date.MINUTE : String
<static> Date interval constant
Date
  Date.MONTH : String
<static> Date interval constant
Date
  Date.SECOND : String
<static> Date interval constant
Date
  Date.YEAR : String
<static> Date interval constant
Date

Public Methods

Method Defined By

Public Events

This class has no public events.