-
Notifications
You must be signed in to change notification settings - Fork 79
Format Specifiers
Format Specifiers are used to specify date formats for display and input.
DateObj.toString( format );
The .toString() function is available in core.js or any compiled /build/ file.
-
format
String. A string consisting of one or more format spcifiers. optional
{String} A string representation of the current Date object. The following Custom and Standard format specifier strings/characters are used with the .toString(format) function.
A Standard format specifier for toString consists of a single character. Useful for simple date output formats. Note - If multiple characters are supplied the string is treated as a Custom format specifier.
Format | Description | Example ("en-US") |
---|---|---|
d | The CultureInfo shortDate Format Pattern | "M/d/yyyy" |
D | The CultureInfo longDate Format Pattern | "dddd, MMMM dd, yyyy" |
F | The CultureInfo fullDateTime Format Pattern | "dddd, MMMM dd, yyyy h:mm:ss tt" |
m | The CultureInfo monthDay Format Pattern | "MMMM dd" |
r | The CultureInfo rfc1123 Format Pattern | "ddd, dd MMM yyyy HH:mm:ss GMT" |
s | The CultureInfo sortableDateTime Format Pattern | "yyyy-MM-ddTHH:mm:ss" |
t | The CultureInfo shortTime Format Pattern | "h:mm tt" |
T | The CultureInfo longTime Format Pattern | "h:mm:ss tt" |
u | The CultureInfo universalSortableDateTime Format Pattern | "yyyy-MM-dd HH:mm:ssZ" |
y | The CultureInfo yearMonth Format Pattern | "MMMM, yyyy" |
Custom formats allow freeform and flexible date formatting.
Format | Description | Example |
---|---|---|
s | The seconds of the minute between 0-59. | "0" to "59" |
ss | The seconds of the minute with leading zero if required. | "00" to "59" |
m | The minute of the hour between 0-59. | "0" or "59" |
mm | The minute of the hour with leading zero if required. | "00" or "59" |
h | The hour of the day between 1-12. | "1" to "12" |
hh | The hour of the day with leading zero if required. | "01" to "12" |
H | The hour of the day between 0-23. | "0" to "23" |
HH | The hour of the day with leading zero if required. | "00" to "23" |
d | The day of the month between 1 and 31. | "1" to "31" |
dd | The day of the month with leading zero if required. | "01" to "31" |
ddd | Abbreviated day name. Date.CultureInfo.abbreviatedDayNames. | "Mon" to "Sun" |
dddd | The full day name. Date.CultureInfo.dayNames. | "Monday" to "Sunday" |
M | The month of the year between 1-12. | "1" to "12" |
MM | The month of the year with leading zero if required. | "01" to "12" |
MMM | Abbreviated month name. Date.CultureInfo.abbreviatedMonthNames. | "Jan" to "Dec" |
MMMM | The full month name. Date.CultureInfo.monthNames. | "January" to "December" |
yy | The year as a two-digit number. | "99" or "08" |
yyyy | The full four digit year. | "1999" or "2008" |
t | Displays the first character of the A.M./P.M. designator. | "A" or "P" |
tt | Displays the A.M./P.M. designator. | "AM" or "PM" |
S | The ordinal suffix ("st, "nd", "rd" or "th") of the current day. | "st, "nd", "rd" or "th" |
.format( format );
The .format() function is available in the optional extras.js module. The extras module is not included with the /build/ file and must be added separately to your page. The core.js (or any /build/ file) is required and must be included before for extras.js.
-
format
String. A format string consisting of one or more format specifiers. optional
String. A string representation of the current Date object.
The following format specifiers are used with the .format(format) or .$format(format) function available by including the extras.js module.
PHP/UNIX FORMAT SPECIFIERS
Format | Description | Example |
---|---|---|
%a | abbreviated weekday name according to the current locale | "Mon" through "Sun" |
%A | full weekday name according to the current locale | "Sunday" through "Saturday" |
%b | abbreviated month name according to the current locale | "Jan" through "Dec" |
%B | full month name according to the current locale | "January" through "December" |
%c | preferred date and time representation for the current locale | "4/13/2008 12:33 PM" |
%C | century number (the year divided by 100 and truncated to an integer) | "00" to "99" |
%d | day of the month as a decimal number | "01" to "31" |
%D | same as %m/%d/%y | "04/13/08" |
%e | day of the month as a decimal number, a single digit is preceded by a space | "1" to "31" |
%g | like %G, but without the century | "08" |
%G | The 4-digit year corresponding to the ISO week number (see %V). | "2008" |
%h | same as %b | "Jan" through "Dec" |
%H | hour as a decimal number using a 24-hour clock | "00" to "23" |
%I | hour as a decimal number using a 12-hour clock | "01" to "12" |
%j | day of the year as a decimal number | "001" to "366" |
%m | month as a decimal number | "01" to "12" |
%M | minute as a decimal number | "00" to "59" |
%n | newline character | "\n" |
%p | either "am" or "pm" according to the given time value | "am" or "pm" |
%r | time in a.m. and p.m. notation | "8:44 PM" |
%R | time in 24 hour notation | "20:44" |
%S | second as a decimal number | "00" to "59" |
%t | tab character | "\t" |
%T | current time, equal to %H:%M:%S | "12:49:11" |
%u | weekday as a decimal number ["1", "7"], with "1" representing Monday | "1" to "7" |
%U | week number of the current year starting with first Sunday as the first day of the first week | "0" to ("52" or "53") |
%V | The ISO 8601:1988 week number of the current year as a decimal number (range 01 to 53) where 1 is the first week that has at least 4 days in the current year, and with Monday as the first day of the week. (Use %G or %g for the year component that corresponds to the week number for the specified timestamp.) | "00" to ("52" or "53") |
%W | week number of the current year as a decimal number, starting with the first Monday as the first day of the first week | "00" to ("52" or "53") |
%w | day of the week as a decimal, Sunday being "0" | "0" to "6" |
%x | preferred date representation for the current locale without the time | "4/13/2008" |
%X | preferred time representation for the current locale without the date | "12:53:05" |
%y | year as a decimal number without a century | "00" "99" |
%Y | year as a decimal number including the century | "2008" |
%Z | time zone or name or abbreviation | "UTC", "EST", "PST" |
%z | same as %Z | |
%% | a literal "%" character | "%" |
d | Day of the month, 2 digits with leading zeros | "01" to "31" |
D | A textual representation of a day, three letters | "Mon" through "Sun" |
j | Day of the month without leading zeros | "1" to "31" |
l | A full textual representation of the day of the week (lowercase "L") | "Sunday" through "Saturday" |
N | ISO-8601 numeric representation of the day of the week (added in PHP 5.1.0) | "1" (for Monday) through "7" |
S | English ordinal suffix for the day of the month, 2 characters | "st", "nd", "rd" or "th". |
w | Numeric representation of the day of the week | "0" (for Sunday) through "6" |
z | The day of the year (starting from "0") | "0" through "365" |
W | ISO-8601 week number of year, weeks starting on Monday | "00" to ("52" or "53") |
F | A full textual representation of a month, such as January or March | "January" through "December" |
m | Numeric representation of a month, with leading zeros | "01" through "12" |
M | A short textual representation of a month, three letters | "Jan" through "Dec" |
n | Numeric representation of a month, without leading zeros | "1" through "12" |
t | Number of days in the given month | "28" through "31" |
L | Whether it's a leap year | "1" if it's a leap year, else 0 |
o | 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. | "2008" |
Y | A full numeric representation of a year, 4 digits | "2008" |
y | A two digit representation of a year | "08" |
a | Lowercase Ante meridiem and Post meridiem | "am" or "pm" |
A | Uppercase Ante meridiem and Post meridiem | "AM" or "PM" |
B | Swatch Internet time | "000" through "999" |
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 | Seconds, with leading zeros | "00" through "59" |
u | Milliseconds | "54321" |
e | Timezone identifier | "UTC", "EST", "PST" |
I | Whether or not the date is in daylight saving time (uppercase i) | "1" if DST else "0" |
O | Difference to Greenwich time (GMT) in hours | "+0200", "-0600" |
P | Difference to Greenwich time (GMT) with colon between hours and minutes | "+02:00", "-06:00" |
T | Timezone abbreviation | "UTC", "EST", "PST" |
Z | Timezone offset in seconds. The offset for timezones west of UTC is always negative, and for those east of UTC is always positive. | "-43200" through "50400" |
c | ISO 8601 date | "2004-02-12T15:19:21+00:00" |
r | RFC 2822 formatted date | "Thu, 21 Dec 2000 16:01:07 +0200" |
U | Seconds since the Unix Epoch (January 1 1970 00:00:00 GMT) | "0" |