Newer Version Available
Formatting Dates in JavaScript
For example, the formatDate() method formats a date based on the formatString parameter set as the second argument.
1formatDate (String | Number | Date date, String formatString)The date parameter can be a String, Number, or most typically a JavaScript Date. If you provide a String value, use ISO 8601 format to avoid parsing warnings.
The formatString parameter contains tokens to format a date and time. For example, "YYYY-MM-DD" formats 15th January, 2017 as "2017-01-15". The default format string comes from the $Locale value provider.
This table shows the list of tokens supported in formatString.
| Description | Token | Output |
|---|---|---|
| Day of month | d | 1 … 31 |
| Day of month | dd | 01 … 31 |
| Day of month. Deprecated. Use dd, which is identical. | DD | 01 … 31 |
| Day of week (number) | E | 0 … 6 |
| Day of week (short name) | EEE | Sun … Sat |
| Day of week (long name) | EEEE | Sunday … Saturday |
| Month | M | 1 ... 12 |
| Month | MM | 01 … 12 |
| Month (short name) | MMM | Jan … Dec |
| Month (full name) | MMMM | January … December |
| Year (two digits) | yy | 17 |
| Year (four digits) | yyyy | 2017 |
| Year. Deprecated. Use yyyy, which is identical. | y | 2017 |
| Year. Deprecated. Use yyyy, which is identical. | Y | 2017 |
| Year. Deprecated. Use yy, which is identical. | YY | 17 |
| Year. Deprecated. Use yyyy, which is identical. | YYYY | 2017 |
| Hour of day (1-12) | h | 1 … 12 |
| Hour of day (0-23) | H | 0 … 23 |
| Hour of day (00-23) | HH | 00 … 23 |
| Hour of day (1-24) | k | 1 … 24 |
| Hour of day (01-24) | kk | 01 … 24 |
| Minute | m | 0 … 59 |
| Minute | mm | 00 … 59 |
| Second | s | 0 … 59 |
| Second | ss | 00 … 59 |
| Fraction of second | SSS | 000 … 999 |
| AM or PM | a | AM or PM |
| AM or PM. Deprecated. Use a, which is identical. | A | AM or PM |
| Zone offset from UTC | Z | -12:00 … +14:00 |
| Quarter of year | Q | 1 … 4 |
| Week of year | w | 1 … 53 |
| Week of year | ww | 01 … 53 |
There are similar methods that differ in their default output values.
- formatDateTime()—The default formatString outputs datetime instead of date.
- formatDateTimeUTC()—Formats a datetime in UTC standard time.
- formatDateUTC()—Formats a date in UTC standard time.
For more information on all the methods in AuraLocalizationService, see JavaScript API.
Example
Use $A.localizationService to use the methods in AuraLocalizationService.
1var now = new Date();
2var dateString = "2017-01-15";
3
4// Returns date in the format "Jun 8, 2017"
5console.log($A.localizationService.formatDate(now));
6
7// Returns date in the format "Jan 15, 2017"
8console.log($A.localizationService.formatDate(dateString));
9
10// Returns date in the format "2017 01 15"
11console.log($A.localizationService.formatDate(dateString, "yyyy MM dd"));
12
13// Returns date in the format "June 08 2017, 01:45:49 PM"
14console.log($A.localizationService.formatDate(now, "MMMM dd yyyy, hh:mm:ss a"));
15
16// Returns date in the format "Jun 08 2017, 01:48:26 PM"
17console.log($A.localizationService.formatDate(now, "MMM dd yyyy, hh:mm:ss a"));