メインコンテンツまでスキップ

date_format

date_format

概要

指定された書式に従って、日付を文字列に変換します。現在、最大128バイトの文字列をサポートしています。戻り値の長さが128を超える場合、NULLが返されます。

構文

VARCHAR DATE_FORMAT(DATETIME date, VARCHAR format)

パラメータ

  • date パラメータは有効な日付または日付式である必要があります。
  • format は日付または時間の出力形式を指定します。

利用可能なフォーマットは以下の通りです:

%a | 短縮された曜日名(日から土まで)
%b | 短縮された月名(1月から12月)
%c | 数値形式の月名(0から12)
%D | 月の日にちを示す数値に、英語のサフィックスが続く形式
%d | 月の日にちを示す数値(00から31)
%e | 月の日にちを示す数値(0から31)
%f | マイクロ秒
%H | 時間(00-23)
%h | 時間(01-12)
%I | 時間(01-12)
%i | 分(00-59)
%j | 年の通算日(001から366)
%k | 時間(0-23)
%l | 時間(1-12)
%M | 月の完全な名前
%m | 月の数値形式の名前(00から12)
%p | AMまたはPM
%r | 12時間表示の時間(hh:mm:ss AMまたはPM)
%S | 秒(00-59)
%s | 秒(00-59)
%T | 24時間表示の時間(hh:mm:ss)
%U | 週(00-53)(日曜日を週の最初の日とする)
%u | 週(00-53)(月曜日を週の最初の日とする)
%V | 週(01-53)(日曜日を週の最初の日とする)(%Xとともに使用)
%v | 週(01-53)(月曜日を週の最初の日とする)(%xとともに使用)
%W | 曜日の完全な名前
%w | 曜日(日曜日=0,土曜日=6)
%X | 週の年(日曜日を週の最初の日とする)。4桁の値。%Vとともに使用。
%x | 週の年(月曜日を週の最初の日とする)。4桁の値。%vとともに使用。
%Y | 年。4桁の値。
%y | 年。2桁の値。
%% | % を表す。

MySQL > 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 |
+------------------------------------------------+

MySQL > 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 |
+------------------------------------------------+

MySQL > 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 |
+------------------------------------------------------------+

MySQL > 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 |
+------------------------------------------------------------+

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

MySQL > select date_format('2006-06-01', '%d');
+------------------------------------------+
| date_format('2006-06-01 00:00:00', '%d') |
+------------------------------------------+
| 01 |
+------------------------------------------+

MySQL > select date_format('2006-06-01', '%%%d');
+--------------------------------------------+
| date_format('2006-06-01 00:00:00', '%%%d') |
+--------------------------------------------+
| %01 |
+--------------------------------------------+

キーワード

DATE_FORMAT,DATE,FORMAT