DATE_FORMAT

説明

フォーマットタイプに従って日付タイプをビット文字列に変換します。

構文

DATE_FORMAT(<date>, <format>)

パラメータ

パラメータ	説明
<date>	有効な日付値
<format>	日付/時刻の出力形式を指定

利用可能な形式：

Format	説明
%a	省略形曜日名 (Sun..Sat)
%b	省略形月名 (Jan..Dec)
%c	月、数値 (0..12)
%D	英語の序数詞付き月日 (0th, 1st, 2nd, 3rd, …)
%d	月日、数値 (00..31)
%e	月日、数値 (0..31)
%f	マイクロ秒 (000000..999999)
%H	時 (00..23)
%h	時 (01..12)
%I	時 (01..12)
%i	分、数値 (00..59)
%j	年の通算日 (001..366)
%k	時 (0..23)
%l	時 (1..12)
%M	月名 (January..December)
%m	月、数値 (00..12)
%p	AM or PM
%r	時刻、12時間形式 (hh:mm:ss followed by AM or PM)
%S	秒 (00..59)
%s	秒 (00..59)
%T	時刻、24時間形式 (hh:mm:ss)
%U	週 (00..53)、日曜日が週の最初の日; WEEK mode 0
%u	週 (00..53)、月曜日が週の最初の日; WEEK mode 1
%V	週 (01..53)、日曜日が週の最初の日; WEEK mode 2; %Xと併用
%v	週 (01..53)、月曜日が週の最初の日; WEEK mode 3; %xと併用
%W	曜日名 (Sunday..Saturday)
%w	曜日 (0=Sunday..6=Saturday)
%X	日曜日が週の最初の日での週の年、数値、4桁; %Vと併用
%x	月曜日が週の最初の日での週の年、数値、4桁; %vと併用
%Y	年、数値、4桁
%y	年、数値（2桁）
%%	リテラル%文字
%x	上記にリストされていない任意の"x"に対するx

また、3つの形式もサポート：

yyyyMMdd
yyyy-MM-dd
yyyy-MM-dd HH:mm:ss

戻り値

フォーマットされた日付文字列。ただし、以下の特殊なケースがあります：

• 現在、最大128バイトの文字列がサポートされています。戻り値が128バイトを超える場合、NULLが返されます。

例

select date_format('2009-10-04 22:23:00', '%W %M %Y');

+------------------------------------------------+
| date_format('2009-10-04 22:23:00', '%W %M %Y') |
+------------------------------------------------+
| Sunday October 2009                            |
+------------------------------------------------+

select date_format('2007-10-04 22:23:00', '%H:%i:%s');

+------------------------------------------------+
| date_format('2007-10-04 22:23:00', '%H:%i:%s') |
+------------------------------------------------+
| 22:23:00                                       |
+------------------------------------------------+

select date_format('1900-10-04 22:23:00', '%D %y %a %d %m %b %j');

+------------------------------------------------------------+
| date_format('1900-10-04 22:23:00', '%D %y %a %d %m %b %j') |
+------------------------------------------------------------+
| 4th 00 Thu 04 10 Oct 277                                   |
+------------------------------------------------------------+

select date_format('1997-10-04 22:23:00', '%H %k %I %r %T %S %w');

+------------------------------------------------------------+
| date_format('1997-10-04 22:23:00', '%H %k %I %r %T %S %w') |
+------------------------------------------------------------+
| 22 22 10 10:23:00 PM 22:23:00 00 6                         |
+------------------------------------------------------------+

select date_format('1999-01-01 00:00:00', '%X %V'); 

+---------------------------------------------+
| date_format('1999-01-01 00:00:00', '%X %V') |
+---------------------------------------------+
| 1998 52                                     |
+---------------------------------------------+

select date_format('2006-06-01', '%d');

+------------------------------------------+
| date_format('2006-06-01 00:00:00', '%d') |
+------------------------------------------+
| 01                                       |
+------------------------------------------+

select date_format('2006-06-01', '%%%d');

+--------------------------------------------+
| date_format('2006-06-01 00:00:00', '%%%d') |
+--------------------------------------------+
| %01                                        |
+--------------------------------------------+