#### Date Field Symbol Table
source: https://unicode-org.github.io/icu/userguide/format_parse/datetime/#date-field-symbol-table
| Symbol | Meaning | Pattern | Example Output |
| --- | --- | --- | --- |
| `G` | era designator | `G`, `GG`, or `GGG`
`GGGG`
`GGGGG` | AD
Anno Domini
A |
| `y` | year | `yy`
`y` or `yyyy` | 96
1996 |
| `Y` | year in “Week of Year” based calendars in which the year transition occurs on a week boundary; may differ from calendar year ‘y’ near a year transition. This year designation is used with pattern character ‘w’ in the ISO 8601 year-week calendar, for example. | `Y` | 1997 |
| `u` | extended year | `u` | 4601 |
| `U` | cyclic year name, as in Chinese lunar calendar | `U` | 甲子 |
| `r` | related Gregorian year | `r` | 1996 |
| `Q` | quarter | `Q`
`QQ`
`QQQ`
`QQQQ`
`QQQQQ` | 2
02
Q2
2nd quarter
2 |
| `q` | stand-alone quarter | `q`
`qq`
`qqq`
`qqqq`
`qqqqq` | 2
02
Q2
2nd quarter
2 |
| `M` | month in year | `M`
`MM`
`MMM`
`MMMM`
`MMMMM` | 9
09
Sep
September
S |
| `L` | stand-alone month in year | `L`
`LL`
`LLL`
`LLLL`
`LLLLL` | 9
09
Sep
September
S |
| `w` | week of year | `w`
`ww` | 27
27 |
| `W` | week of month | `W` | 2 |
| `d` | day in month | `d`
`dd` | 2
02 |
| `D` | day of year | `D` | 189 |
| `F` | day of week in month | `F` | 2 (2nd Wed in July) |
| `g` | modified julian day | `g` | 2451334 |
| `E` | day of week | `E,` `EE`, or `EEE`
`EEEE`
`EEEEE`
`EEEEEE` | Tue
Tuesday
T
Tu |
| `e` | local day of week
example: if Monday is 1st day, Tuesday is 2nd ) | `e`
`ee`
`eee`
`eeee`
`eeeee`
`eeeeee` | 2
02
Tue
Tuesday
T
Tu |
| `c` | stand-alone local day of week | `c` or `cc`
`ccc`
`cccc`
`ccccc`
`cccccc` | 2
Tue
Tuesday
T
Tu |
| `a` | AM or PM | `a`, `aa`, or `aaa`
`aaaa`
`aaaaa` | PM [abbrev]
PM [wide]
p |
| `b` | am, pm, noon, midnight | `b`, `bb`, or `bbb`
`bbbb`
`bbbbb` | mid.
midnight
md |
| `B` | flexible day periods | `B`, `BB`, or `BBB`
`BBBB`
`BBBBB` | at night [abbrev]
at night [wide]
at night [narrow] |
| `h` | hour in am/pm (1~12) | `h`
`hh` | 7
07 |
| `H` | hour in day (0~23) | `H`
`HH` | 0
00 |
| `k` | hour in day (1~24) | `k`
`kk` | 24
24 |
| `K` | hour in am/pm (0~11) | `K`
`KK` | 0
00 |
| `m` | minute in hour | `m`
`mm` | 4
04 |
| `s` | second in minute | `s`
`ss` | 5
05 |
| `S` | fractional second - truncates (like other time fields)
to the count of letters when formatting. Appends
zeros if more than 3 letters specified. Truncates at
three significant digits when parsing. | `S`
`SS`
`SSS`
`SSSS` | 2
23
235
2350 |
| `A` | milliseconds in day | `A` | 61201235 |
| `z` | Time Zone: specific non-location | `z`, `zz`, or `zzz`
`zzzz` | PDT
Pacific Daylight Time |
| `Z` | Time Zone: ISO8601 basic hms? / RFC 822
Time Zone: long localized GMT (=OOOO)
Time Zone: ISO8601 extended hms? (=XXXXX) | `Z`, `ZZ`, or `ZZZ`
`ZZZZ`
`ZZZZZ` | -0800
GMT-08:00
-08:00, -07:52:58, Z |
| `O` | Time Zone: short localized GMT
Time Zone: long localized GMT (=ZZZZ) | `O`
`OOOO` | GMT-8
GMT-08:00 |
| `v` | Time Zone: generic non-location
(falls back first to VVVV) | `v`
`vvvv` | PT
Pacific Time or Los Angeles Time |
| `V` | Time Zone: short time zone ID
Time Zone: long time zone ID
Time Zone: time zone exemplar city
Time Zone: generic location (falls back to OOOO) | `V`
`VV`
`VVV`
`VVVV` | uslax
America/Los_Angeles
Los Angeles
Los Angeles Time |
| `X` | Time Zone: ISO8601 basic hm?, with Z for 0
Time Zone: ISO8601 basic hm, with Z
Time Zone: ISO8601 extended hm, with Z
Time Zone: ISO8601 basic hms?, with Z
Time Zone: ISO8601 extended hms?, with Z | `X`
`XX`
`XXX`
`XXXX`
`XXXXX` | -08, +0530, Z
-0800, Z
-08:00, Z
-0800, -075258, Z
-08:00, -07:52:58, Z |
| `x` | Time Zone: ISO8601 basic hm?, without Z for 0
Time Zone: ISO8601 basic hm, without Z
Time Zone: ISO8601 extended hm, without Z
Time Zone: ISO8601 basic hms?, without Z
Time Zone: ISO8601 extended hms?, without Z | `x`
`xx`
`xxx`
`xxxx`
`xxxxx` | -08, +0530
-0800
-08:00
-0800, -075258
-08:00, -07:52:58 |
| `'` | escape for text | `'` | (nothing) |
| `''` | two single quotes produce one | `''` | ' |
> :point_right: **Note**: *Any characters in the pattern that are not in the ranges of
['a'..'z'] and ['A'..'Z'] will be treated as quoted text. For instance,
characters like `':'`, `'.'`, `' '`, `'#'` and `'@'` will appear in the resulting time
text even they are not enclosed within single quotes. The single quote is used to
'escape' letters. Two single quotes in a row, whether inside or outside a quoted
sequence, represent a 'real' single quote.*
> :point_right: **Note**: *A pattern containing any invalid pattern letter results in a failing `UErrorCode`
result during formatting or parsing.*
| Format Pattern | Result |
| --- | --- |
| `"yyyy.MM.dd G 'at' HH:mm:ss zzz"` | "1996.07.10 AD at 15:08:56 PDT" |
| `"EEE, MMM d, ''yy"` | "Wed, July 10, '96" |
| `"h:mm a"` | "12:08 PM" |
| `"hh 'o''clock' a, zzzz"` | "12 o'clock PM, Pacific Daylight Time" |
| `"K:mm a, z"` | "0:00 PM, PST" |
| `"yyyyy.MMMM.dd GGG hh:mm aaa"` | "01996.July.10 AD 12:08 PM" |