date-format.md
11.8 KB
Pre-defined format options
| Option | Equivalent to | Examples (given in en-US locale) |
|---|---|---|
| short | M/d/yy, h:mm a | 6/15/15, 9:03 AM |
| medium | MMM d, y, h ss a |
Jun 15, 2015, 9:03:01 AM |
| long | MMMM d, y, hss a z |
June 15, 2015 at 9:03:01 AM GMT+1 |
| full | EEEE, MMMM d, y, hss a zzzz |
Monday, June 15, 2015 at 9:03:01 AM GMT+01:00 |
| shortDate | M/d/yy | 6/15/15 |
| mediumDate | MMM d, y | Jun 15, 2015 |
| longDate | MMMM d, y | June 15, 2015 |
| fullDate | EEEE, MMMM d, y | Monday, June 15, 2015 |
| shortTime | h:mm a | 9:03 AM |
| mediumTime | hss a |
9:03:01 AM |
| longTime | hss a z |
9:03:01 AM GMT+1 |
| fullTime | hss a zzzz |
9:03:01 AM GMT+01:00 |
Custom format options
You can construct a format string using symbols to specify the components of a date-time value, as described in the following table. Format details depend on the locale. Fields marked with (*) are only available in the extra data set for the given locale.
| Field type | Format | Description | Example Value |
|---|---|---|---|
| Era | G, GG & GGG | Abbreviated | AD |
| GGGG | Wide | Anno Domini | |
| GGGGG | Narrow | A | |
| Year | y | Numeric: minimum digits | 2, 20, 201, 2017, 20173 |
| yy | Numeric: 2 digits + zero padded | 02, 20, 01, 17, 73 | |
| yyy | Numeric: 3 digits + zero padded | 002, 020, 201, 2017, 20173 | |
| yyyy | Numeric: 4 digits or more + zero padded | 0002, 0020, 0201, 2017, 20173 | |
| Week-numbering year | Y | Numeric: minimum digits | 2, 20, 201, 2017, 20173 |
| YY | Numeric: 2 digits + zero padded | 02, 20, 01, 17, 73 | |
| YYY | Numeric: 3 digits + zero padded | 002, 020, 201, 2017, 20173 | |
| YYYY | Numeric: 4 digits or more + zero padded | 0002, 0020, 0201, 2017, 20173 | |
| Month | M | Numeric: 1 digit | 9, 12 |
| MM | Numeric: 2 digits + zero padded | 09, 12 | |
| MMM | Abbreviated | Sep | |
| MMMM | Wide | September | |
| MMMMM | Narrow | S | |
| Month standalone | L | Numeric: 1 digit | 9, 12 |
| LL | Numeric: 2 digits + zero padded | 09, 12 | |
| LLL | Abbreviated | Sep | |
| LLLL | Wide | September | |
| LLLLL | Narrow | S | |
| Week of year | w | Numeric: minimum digits | 1... 53 |
| ww | Numeric: 2 digits + zero padded | 01... 53 | |
| Week of month | W | Numeric: 1 digit | 1... 5 |
| Day of month | d | Numeric: minimum digits | 1 |
| dd | Numeric: 2 digits + zero padded | 01 | |
| Week day | E, EE & EEE | Abbreviated | Tue |
| EEEE | Wide | Tuesday | |
| EEEEE | Narrow | T | |
| EEEEEE | Short | Tu | |
| Week day standalone | c, cc | Numeric: 1 digit | 2 |
| ccc | Abbreviated | Tue | |
| cccc | Wide | Tuesday | |
| ccccc | Narrow | T | |
| cccccc | Short | Tu | |
| Period | a, aa & aaa | Abbreviated | am/pm or AM/PM |
| aaaa | Wide (fallback to a when missing) |
ante meridiem/post meridiem | |
| aaaaa | Narrow | a/p | |
| Period* | B, BB & BBB | Abbreviated | mid. |
| BBBB | Wide | am, pm, midnight, noon, morning, afternoon, evening, night | |
| BBBBB | Narrow | md | |
| Period standalone* | b, bb & bbb | Abbreviated | mid. |
| bbbb | Wide | am, pm, midnight, noon, morning, afternoon, evening, night | |
| bbbbb | Narrow | md | |
| Hour 1-12 | h | Numeric: minimum digits | 1, 12 |
| hh | Numeric: 2 digits + zero padded | 01, 12 | |
| Hour 0-23 | H | Numeric: minimum digits | 0, 23 |
| HH | Numeric: 2 digits + zero padded | 00, 23 | |
| Minute | m | Numeric: minimum digits | 8, 59 |
| mm | Numeric: 2 digits + zero padded | 08, 59 | |
| Second | s | Numeric: minimum digits | 0... 59 |
| ss | Numeric: 2 digits + zero padded | 00... 59 | |
| Fractional seconds | S | Numeric: 1 digit | 0... 9 |
| SS | Numeric: 2 digits + zero padded | 00... 99 | |
| SSS | Numeric: 3 digits + zero padded (= milliseconds) | 000... 999 | |
| Zone | z, zz & zzz | Short specific non location format (fallback to O) | GMT-8 |
| zzzz | Long specific non location format (fallback to OOOO) | GMT-08:00 | |
| Z, ZZ & ZZZ | ISO8601 basic format | -0800 | |
| ZZZZ | Long localized GMT format | GMT-8:00 | |
| ZZZZZ | ISO8601 extended format + Z indicator for offset 0 (= XXXXX) | -08:00 | |
| O, OO & OOO | Short localized GMT format | GMT-8 | |
| OOOO | Long localized GMT format | GMT-08:00 |