date_format
date_format(timestamp, fmt)
Converts a date into a string in the format specified by fmt.
Example:
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 |
SELECT date_format('2009-10-04 22:23:00', '%M %D %W'); date_format -------------------- October 4th Sunday (1 row) SELECT date_format('2021-02-20 08:30:45', '%Y-%m-%d %H:%i:%S'); date_format --------------------- 2021-02-20 08:30:45 (1 row) SELECT date_format('2021-02-20 18:10:15', '%r-%T'); date_format ---------------------- 06:10:15 PM-18:10:15 (1 row) |
Table 1 describes the patterns of date parameter values. They can be used for the date_format, time_format, str_to_date, str_to_time, and from_unixtime functions.
Format |
Description |
Value |
---|---|---|
%a |
Abbreviated week name |
Sun...Sat |
%b |
Abbreviated month name |
Jan...Dec |
%c |
Month |
0...12 |
%D |
Date with a suffix |
0th, 1st, 2nd, 3rd, ... |
%d |
Day in a month (two digits) |
00...31 |
%e |
Day in a month |
0...31 |
%f |
Microsecond |
000000...999999 |
%H |
Hour, in 24-hour format |
00...23 |
%h |
Hour, in 12-hour format |
01...12 |
%I |
Hour, in 12-hour format, same as %h |
01...12 |
%i |
Minute |
00...59 |
%j |
Day in a year |
001...366 |
%k |
Hour, in 24-hour format, same as %H |
0...23 |
%l |
Hour, in 12-hour format, same as %h |
1...12 |
%M |
Month name |
January...December |
%m |
Month (two digits) |
00...12 |
%p |
Morning and afternoon |
AM PM |
%r |
Time, in 12-hour format |
hh::mm::ss AM/PM |
%S |
Second |
00...59 |
%s |
Second, same as %S |
00...59 |
%T |
Time, in 24-hour format |
hh::mm::ss |
%U |
Week (Sunday is the first day of a week.) |
00...53 |
%u |
Week (Monday is the first day of a week.) |
00...53 |
%V |
Week (Sunday is the first day of a week). It is used together with %X. |
01...53 |
%v |
Week (Monday is the first day of a week). It is used together with %x. |
01...53 |
%W |
Week name |
Sunday...Saturday |
%w |
Day of a week. The value is 0 for Sunday. |
0...6 |
%X |
Year (four digits). It is used together with %V. Sunday is the first day of a week. |
- |
%x |
Year (four digits). It is used together with %v. Monday is the first day of a week. |
- |
%Y |
Year (four digits) |
- |
%y |
Year (two digits) |
- |
%% |
Character '%' |
Character '%' |
%x |
'x': any character apart from the preceding ones |
Character 'x' |
In the preceding table, %U, %u, %V, %v, %X, and %x are not supported currently.
Feedback
Was this page helpful?
Provide feedbackThank you very much for your feedback. We will continue working to improve the documentation.