@@ -28,194 +28,38 @@ There are several common scenarios for datetime usage in Spark:
2828
2929Spark uses pattern letters in the following table for date and timestamp parsing and formatting:
3030
31- <table class =" table " >
32- <tr >
33- <th > <b >Symbol</b > </th >
34- <th > <b >Meaning</b > </th >
35- <th > <b >Presentation</b > </th >
36- <th > <b >Examples</b > </th >
37- </tr >
38- <tr >
39- <td > <b >G</b > </td >
40- <td > era </td >
41- <td > text </td >
42- <td > AD; Anno Domini; A </td >
43- </tr >
44- <tr >
45- <td > <b >y</b > </td >
46- <td > year </td >
47- <td > year </td >
48- <td > 2020; 20 </td >
49- </tr >
50- <tr >
51- <td > <b >D</b > </td >
52- <td > day-of-year </td >
53- <td > number </td >
54- <td > 189 </td >
55- </tr >
56- <tr >
57- <td > <b >M/L</b > </td >
58- <td > month-of-year </td >
59- <td > number/text </td >
60- <td > 7; 07; Jul; July; J </td >
61- </tr >
62- <tr >
63- <td > <b >d</b > </td >
64- <td > day-of-month </td >
65- <td > number </td >
66- <td > 28 </td >
67- </tr >
68- <tr >
69- <td > <b >Q/q</b > </td >
70- <td > quarter-of-year </td >
71- <td > number/text </td >
72- <td > 3; 03; Q3; 3rd quarter </td >
73- </tr >
74- <tr >
75- <td > <b >Y</b > </td >
76- <td > week-based-year </td >
77- <td > year </td >
78- <td > 1996; 96 </td >
79- </tr >
80- <tr >
81- <td > <b >w</b > </td >
82- <td > week-of-week-based-year </td >
83- <td > number </td >
84- <td > 27 </td >
85- </tr >
86- <tr >
87- <td > <b >W</b > </td >
88- <td > week-of-month </td >
89- <td > number </td >
90- <td > 4 </td >
91- </tr >
92- <tr >
93- <td > <b >E</b > </td >
94- <td > day-of-week </td >
95- <td > text </td >
96- <td > Tue; Tuesday; T </td >
97- </tr >
98- <tr >
99- <td > <b >u</b > </td >
100- <td > localized day-of-week </td >
101- <td > number/text </td >
102- <td > 2; 02; Tue; Tuesday; T </td >
103- </tr >
104- <tr >
105- <td > <b >F</b > </td >
106- <td > week-of-month </td >
107- <td > number </td >
108- <td > 3 </td >
109- </tr >
110- <tr >
111- <td > <b >a</b > </td >
112- <td > am-pm-of-day </td >
113- <td > text </td >
114- <td > PM </td >
115- </tr >
116- <tr >
117- <td > <b >h</b > </td >
118- <td > clock-hour-of-am-pm (1-12) </td >
119- <td > number </td >
120- <td > 12 </td >
121- </tr >
122- <tr >
123- <td > <b >K</b > </td >
124- <td > hour-of-am-pm (0-11) </td >
125- <td > number </td >
126- <td > 0 </td >
127- </tr >
128- <tr >
129- <td > <b >k</b > </td >
130- <td > clock-hour-of-day (1-24) </td >
131- <td > number </td >
132- <td > 0 </td >
133- </tr >
134- <tr >
135- <td > <b >H</b > </td >
136- <td > hour-of-day (0-23) </td >
137- <td > number </td >
138- <td > 0 </td >
139- </tr >
140- <tr >
141- <td > <b >m</b > </td >
142- <td > minute-of-hour </td >
143- <td > number </td >
144- <td > 30 </td >
145- </tr >
146- <tr >
147- <td > <b >s</b > </td >
148- <td > second-of-minute </td >
149- <td > number </td >
150- <td > 55 </td >
151- </tr >
152- <tr >
153- <td > <b >S</b > </td >
154- <td > fraction-of-second </td >
155- <td > fraction </td >
156- <td > 978 </td >
157- </tr >
158- <tr >
159- <td > <b >V</b > </td >
160- <td > time-zone ID </td >
161- <td > zone-id </td >
162- <td > America/Los_Angeles; Z; -08:30 </td >
163- </tr >
164- <tr >
165- <td > <b >z</b > </td >
166- <td > time-zone name </td >
167- <td > zone-name </td >
168- <td > Pacific Standard Time; PST </td >
169- </tr >
170- <tr >
171- <td > <b >O</b > </td >
172- <td > localized zone-offset </td >
173- <td > offset-O </td >
174- <td > GMT+8; GMT+08:00; UTC-08:00; </td >
175- </tr >
176- <tr >
177- <td > <b >X</b > </td >
178- <td > zone-offset 'Z' for zero </td >
179- <td > offset-X </td >
180- <td > Z; -08; -0830; -08:30; -083015; -08:30:15; </td >
181- </tr >
182- <tr >
183- <td > <b >x</b > </td >
184- <td > zone-offset </td >
185- <td > offset-x </td >
186- <td > +0000; -08; -0830; -08:30; -083015; -08:30:15; </td >
187- </tr >
188- <tr >
189- <td > <b >Z</b > </td >
190- <td > zone-offset </td >
191- <td > offset-Z </td >
192- <td > +0000; -0800; -08:00; </td >
193- </tr >
194- <tr >
195- <td > <b >'</b > </td >
196- <td > escape for text </td >
197- <td > delimiter </td >
198- <td ></td >
199- </tr >
200- <tr >
201- <td > <b >''</b > </td >
202- <td > single quote </td >
203- <td > literal </td >
204- <td > ' </td >
205- </tr >
206- <tr >
207- <td > <b >[</b > </td >
208- <td > optional section start </td >
209- <td > </td >
210- <td > </td >
211- </tr >
212- <tr >
213- <td > <b >]</b > </td >
214- <td > optional section end </td >
215- <td > </td >
216- <td > </td >
217- </tr >
218- </table >
31+ | Symbol| Meaning| Presentation| Examples|
32+ | --- | --- | --- | --- |
33+ | ** G** | era| text| AD; Anno Domini; A|
34+ | ** y** | year| year| 2020; 20|
35+ | ** D** | day-of-year| number| 189|
36+ | ** M/L** | month-of-year| number/text| 7; 07; Jul; July; J|
37+ | ** d** | day-of-month| number| 28|
38+ | ** Q/q** | quarter-of-year| number/text| 3; 03; Q3; 3rd quarter|
39+ | ** Y** | week-based-year| year| 1996; 96|
40+ | ** w** | week-of-week-based-year| number| 27|
41+ | ** W** | week-of-month| number| 4|
42+ | ** E** | day-of-week| text| Tue; Tuesday; T|
43+ | ** u** | localized day-of-week| number/text| 2; 02; Tue; Tuesday; T|
44+ | ** F** | week-of-month| number| 3|
45+ | ** a** | am-pm-of-day| text| PM|
46+ | ** h** | clock-hour-of-am-pm (1-12)| number| 12|
47+ | ** K** | hour-of-am-pm (0-11)| number| 0|
48+ | ** k** | clock-hour-of-day (1-24)| number| 0|
49+ | ** H** | hour-of-day (0-23)| number| 0|
50+ | ** m** | minute-of-hour| number| 30|
51+ | ** s** | second-of-minute| number| 55|
52+ | ** S** | fraction-of-second| fraction| 978|
53+ | ** V** | time-zone ID| zone-id| America/Los_Angeles; Z; -08:30|
54+ | ** z** | time-zone name| zone-name| Pacific Standard Time; PST|
55+ | ** O** | localized zone-offset| offset-O| GMT+8; GMT+08:00; UTC-08:00;|
56+ | ** X** | zone-offset 'Z' for zero| offset-X| Z; -08; -0830; -08:30; -083015; -08:30:15;|
57+ | ** x** | zone-offset| offset-x| +0000; -08; -0830; -08:30; -083015; -08:30:15;|
58+ | ** Z** | zone-offset| offset-Z| +0000; -0800; -08:00;|
59+ | ** '** | escape for text| delimiter||
60+ | ** ''** | single quote| literal| '|
61+ | ** [ ** | optional section start|||
62+ | ** ] ** | optional section end|||
21963
22064The count of pattern letters determines the format.
22165
0 commit comments