diff --git a/docs/sql-ref-datetime-pattern.md b/docs/sql-ref-datetime-pattern.md index 80585a4fd484..e606383c9432 100644 --- a/docs/sql-ref-datetime-pattern.md +++ b/docs/sql-ref-datetime-pattern.md @@ -28,194 +28,38 @@ There are several common scenarios for datetime usage in Spark: Spark uses pattern letters in the following table for date and timestamp parsing and formatting: - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
Symbol Meaning Presentation Examples
G era text AD; Anno Domini; A
y year year 2020; 20
D day-of-year number 189
M/L month-of-year number/text 7; 07; Jul; July; J
d day-of-month number 28
Q/q quarter-of-year number/text 3; 03; Q3; 3rd quarter
Y week-based-year year 1996; 96
w week-of-week-based-year number 27
W week-of-month number 4
E day-of-week text Tue; Tuesday; T
u localized day-of-week number/text 2; 02; Tue; Tuesday; T
F week-of-month number 3
a am-pm-of-day text PM
h clock-hour-of-am-pm (1-12) number 12
K hour-of-am-pm (0-11) number 0
k clock-hour-of-day (1-24) number 0
H hour-of-day (0-23) number 0
m minute-of-hour number 30
s second-of-minute number 55
S fraction-of-second fraction 978
V time-zone ID zone-id America/Los_Angeles; Z; -08:30
z time-zone name zone-name Pacific Standard Time; PST
O localized zone-offset offset-O GMT+8; GMT+08:00; UTC-08:00;
X zone-offset 'Z' for zero offset-X Z; -08; -0830; -08:30; -083015; -08:30:15;
x zone-offset offset-x +0000; -08; -0830; -08:30; -083015; -08:30:15;
Z zone-offset offset-Z +0000; -0800; -08:00;
' escape for text delimiter
'' single quote literal '
[ optional section start
] optional section end
+|Symbol|Meaning|Presentation|Examples| +|--- |--- |--- |--- | +|**G**|era|text|AD; Anno Domini; A| +|**y**|year|year|2020; 20| +|**D**|day-of-year|number|189| +|**M/L**|month-of-year|number/text|7; 07; Jul; July; J| +|**d**|day-of-month|number|28| +|**Q/q**|quarter-of-year|number/text|3; 03; Q3; 3rd quarter| +|**Y**|week-based-year|year|1996; 96| +|**w**|week-of-week-based-year|number|27| +|**W**|week-of-month|number|4| +|**E**|day-of-week|text|Tue; Tuesday; T| +|**u**|localized day-of-week|number/text|2; 02; Tue; Tuesday; T| +|**F**|week-of-month|number|3| +|**a**|am-pm-of-day|text|PM| +|**h**|clock-hour-of-am-pm (1-12)|number|12| +|**K**|hour-of-am-pm (0-11)|number|0| +|**k**|clock-hour-of-day (1-24)|number|0| +|**H**|hour-of-day (0-23)|number|0| +|**m**|minute-of-hour|number|30| +|**s**|second-of-minute|number|55| +|**S**|fraction-of-second|fraction|978| +|**V**|time-zone ID|zone-id|America/Los_Angeles; Z; -08:30| +|**z**|time-zone name|zone-name|Pacific Standard Time; PST| +|**O**|localized zone-offset|offset-O|GMT+8; GMT+08:00; UTC-08:00;| +|**X**|zone-offset 'Z' for zero|offset-X|Z; -08; -0830; -08:30; -083015; -08:30:15;| +|**x**|zone-offset|offset-x|+0000; -08; -0830; -08:30; -083015; -08:30:15;| +|**Z**|zone-offset|offset-Z|+0000; -0800; -08:00;| +|**'**|escape for text|delimiter|| +|**''**|single quote|literal|'| +|**[**|optional section start||| +|**]**|optional section end||| The count of pattern letters determines the format.