Перейти к основному содержимому

date_format

Описание

Преобразует дату в строку согласно указанному формату. В настоящее время поддерживаются строки максимальной длиной 128 байт. Если длина возвращаемого значения превышает 128, возвращается NULL.

Синтаксис

VARCHAR DATE_FORMAT(DATETIME date, VARCHAR format)

Параметры

  • Параметр date должен быть действительной датой или выражением даты.

  • format указывает выходной формат даты или времени.

Вот доступные форматы:

%a | Сокращенное название дня недели (Sun to Sat)
%b | Сокращенное название месяца (Jan to Dec)
%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