Spec-Zone.ru › MySQL 9.2

11.1.3 Литералы дат и времени

  • Стандартные SQL и ODBC литералы дат и времени

  • Строчные и числовые литералы в контексте дат и времени

Значения дат и времени могут быть представлены в нескольких форматах, таких как строковые значения в кавычках или числа, в зависимости от конкретного типа значения и других факторов. Например, в контекстах, где MySQL ожидает дату, он интерпретирует любое из '2015-07-21', '20150721' и 20150721 как дату.

В этом разделе описаны допустимые форматы литералов дат и времени. Более подробную информацию о типах временных данных, таких как диапазон допустимых значений, см. в Разделе 13.2 «Типы данных дат и времени».

Стандартные SQL и ODBC литералы дат и времени

Стандарт SQL требует, чтобы временные литералы были заданы с использованием ключевого слова типа и строки. Пробел между ключевым словом и строкой является необязательным.

DATE 'str'
TIME 'str'
TIMESTAMP 'str'

MySQL распознает, но, в отличие от стандартного SQL, не требует ключевого слова типа. Приложения, которые должны соответствовать стандарту, должны включать ключевое слово типа для временных литералов.

MySQL также распознает синтаксис ODBC, соответствующий стандартному синтаксису SQL:

{ d 'str' }
{ t 'str' }
{ ts 'str' }

MySQL использует ключевые слова типа и конструкции ODBC для получения значений DATE, TIME и DATETIME соответственно, включая хвостовую дробную часть секунды, если она указана. Синтаксис TIMESTAMP генерирует значение DATETIME в MySQL, так как DATETIME имеет диапазон, который более точно соответствует типу стандартного SQL TIMESTAMP, у которого диапазон годов от 0001 до 9999. (Диапазон лет MySQL TIMESTAMP составляет от 1970 до 2038.)

Строковые и числовые литералы в контексте даты и времени

MySQL распознаёт значения DATE в следующих форматах:

  • В виде строки в формате 'YYYY-MM-DD' или 'YY-MM-DD'. Разрешён “расслабленный” синтаксис, но он устарел: любой символ пунктуации может использоваться в качестве разделителя между частями даты. Например, '2012-12-31', '2012/12/31', '2012^12^31' и '2012@12@31' эквивалентны. Использование любого символа, кроме тире (-), в качестве разделителя вызывает предупреждение, как показано здесь: 

    mysql> SELECT DATE'2012@12@31';
+------------------+
| DATE'2012@12@31' |
+------------------+
| 2012-12-31       |
+------------------+
1 row in set, 1 warning (0.00 sec)

mysql> SHOW WARNINGS\G
*************************** 1. row ***************************
  Level: Warning
   Code: 4095
Message: Delimiter '@' in position 4 in datetime value '2012@12@31' at row 1 is
deprecated. Prefer the standard '-'.
1 row in set (0.00 sec)

  • В виде строки без разделителей в формате 'YYYYMMDD' или 'YYMMDD', при условии, что строка имеет смысл как дата. Например, '20070523' и '070523' интерпретируются как '2007-05-23', но '071332' некорректно (имеет бессмысленные части месяца и дня) и становится '0000-00-00'.

  • В виде числа в формате YYYYMMDD или YYMMDD, при условии, что число имеет смысл как дата. Например, 19830905 и 830905 интерпретируются как '1983-09-05'.

MySQL распознаёт значения DATETIME и TIMESTAMP в следующих форматах:

  • В виде строки в формате 'YYYY-MM-DD hh:mm:ss' или 'YY-MM-DD hh:mm:ss'. MySQL также допускает “расслабленный” синтаксис, хотя он устарел: любой символ пунктуации может использоваться в качестве разделителя между частями даты или времени. Например, '2012-12-31 11:30:45', '2012^12^31 11+30+45', '2012/12/31 11*30*45' и '2012@12@31 11^30^45' эквивалентны. Использование любых символов в качестве разделителей в таких значениях, кроме тире (-) для части даты и двоеточия (:) для части времени, вызывает предупреждение, как показано здесь: 

    mysql> SELECT TIMESTAMP'2012^12^31 11*30*45';
+--------------------------------+
| TIMESTAMP'2012^12^31 11*30*45' |
+--------------------------------+
| 2012-12-31 11:30:45            |
+--------------------------------+
1 row in set, 1 warning (0.00 sec)

mysql> SHOW WARNINGS\G
*************************** 1. row ***************************
  Level: Warning
   Code: 4095
Message: Delimiter '^' in position 4 in datetime value '2012^12^31 11*30*45' at
row 1 is deprecated. Prefer the standard '-'.
1 row in set (0.00 sec)

    Единственный разделитель, распознаваемый между частью даты/времени и частью дробных секунд, — это десятичная точка.

    Части даты и времени могут быть разделены T вместо пробела. Например, '2012-12-31 11:30:45' и '2012-12-31T11:30:45' эквивалентны.

    Ранее MySQL поддерживал произвольное количество символов пробела в начале и конце значений даты и времени, а также между частями даты и времени значений DATETIME и TIMESTAMP. В MySQL 9.2 это поведение устарело, и наличие лишних пробелов вызывает предупреждение, как показано здесь: 

    mysql> SELECT TIMESTAMP'2012-12-31   11-30-45';
+----------------------------------+
| TIMESTAMP'2012-12-31   11-30-45' |
+----------------------------------+
| 2012-12-31 11:30:45              |
+----------------------------------+
1 row in set, 1 warning (0.00 sec)

mysql> SHOW WARNINGS\G
*************************** 1. row ***************************
  Level: Warning
   Code: 4096
Message: Delimiter ' ' in position 11 in datetime value '2012-12-31   11-30-45'
at row 1 is superfluous and is deprecated. Please remove.
1 row in set (0.00 sec)

    Предупреждение также генерируется, когда используются символы пробела, отличные от пробела, как в этом примере: 

    mysql> SELECT TIMESTAMP'2021-06-06
    '> 11:15:25';
+--------------------------------+
| TIMESTAMP'2021-06-06
 11:15:25'                       |
+--------------------------------+
| 2021-06-06 11:15:25            |
+--------------------------------+
1 row in set, 1 warning (0.00 sec)

mysql> SHOW WARNINGS\G
*************************** 1. row ***************************
  Level: Warning
   Code: 4095
Message: Delimiter '\n' in position 10 in datetime value '2021-06-06
11:15:25' at row 1 is deprecated. Prefer the standard ' '.
1 row in set (0.00 sec)

    Только одно такое предупреждение генерируется для каждого временного значения, даже если могут существовать несколько проблем с разделителями, пробелами или тем и другим, как показано в следующей серии инструкций: 

    mysql> SELECT TIMESTAMP'2012!-12-31  11:30:45';
+----------------------------------+
| TIMESTAMP'2012!-12-31  11:30:45' |
+----------------------------------+
| 2012-12-31 11:30:45              |
+----------------------------------+
1 row in set, 1 warning (0.00 sec)

mysql> SHOW WARNINGS\G
*************************** 1. row ***************************
  Level: Warning
   Code: 4095
Message: Delimiter '!' in position 4 in datetime value '2012!-12-31  11:30:45'
at row 1 is deprecated. Prefer the standard '-'.
1 row in set (0.00 sec)

mysql> SELECT TIMESTAMP'2012-12-31  11:30:45';
+---------------------------------+
| TIMESTAMP'2012-12-31  11:30:45' |
+---------------------------------+
| 2012-12-31 11:30:45             |
+---------------------------------+
1 row in set, 1 warning (0.00 sec)

mysql> SHOW WARNINGS\G
*************************** 1. row ***************************
  Level: Warning
   Code: 4096
Message: Delimiter ' ' in position 11 in datetime value '2012-12-31  11:30:45'
at row 1 is superfluous and is deprecated. Please remove.
1 row in set (0.00 sec)

mysql> SELECT TIMESTAMP'2012-12-31 11:30:45';
+--------------------------------+
| TIMESTAMP'2012-12-31 11:30:45' |
+--------------------------------+
| 2012-12-31 11:30:45            |
+--------------------------------+
1 row in set (0.00 sec)

  • В виде строки без разделителей в формате 'YYYYMMDDhhmmss' или 'YYMMDDhhmmss', при условии, что строка имеет смысл как дата. Например, '20070523091528' и '070523091528' интерпретируются как '2007-05-23 09:15:28', но '071122129015' некорректно (имеет бессмысленную часть минут) и становится '0000-00-00 00:00:00'.

  • В виде числа в формате YYYYMMDDhhmmss или YYMMDDhhmmss, при условии, что число имеет смысл как дата. Например, 19830905132800 и 830905132800 интерпретируются как '1983-09-05 13:28:00'.

Значение DATETIME или TIMESTAMP может содержать конечную часть дробных секунд с точностью до микросекунд (6 цифр). Дробная часть всегда должна быть отделена от остальной части времени десятичной точкой; другие разделители дробных секунд не распознаются. Сведения о поддержке дробных секунд в MySQL см. в Разделе 13.2.6, «Дробные секунды во временных значениях».

Даты, содержащие значения года с двумя цифрами, неоднозначны, так как век неизвестен. MySQL интерпретирует значения года с двумя цифрами по этим правилам:

  • Значения года в диапазоне 70-99 становятся 1970-1999.

  • Значения года в диапазоне 00-69 становятся 2000-2069.

См. также Раздел 13.2.9, «Года с двумя цифрами в датах».

Для значений, заданных строками, содержащими разделители частей даты, нет необходимости указывать две цифры для значений месяца или дня, которые меньше 10. '2015-6-9' эквивалентно '2015-06-09'. Аналогично, для значений, заданных строками, содержащими разделители частей времени, нет необходимости указывать две цифры для значений часов, минут или секунд, которые меньше 10. '2015-10-30 1:2:3' эквивалентно '2015-10-30 01:02:03'.

Значения, заданные в виде чисел, должны иметь длину 6, 8, 12 или 14 цифр. Если число имеет длину 8 или 14 цифр, предполагается, что оно имеет формат YYYYMMDD или YYYYMMDDhhmmss, и год задаётся первыми 4 цифрами. Если число имеет длину 6 или 12 цифр, предполагается, что оно имеет формат YYMMDD или YYMMDDhhmmss, и год задаётся первыми 2 цифрами. Числа, длина которых не соответствует этим значениям, интерпретируются так, как будто они дополнены ведущими нулями до ближайшей длины.

Значения, заданные в виде строк без разделителей, интерпретируются в зависимости от их длины. Для строк длиной 8 или 14 символов год предполагается заданным первыми 4 символами. В противном случае год предполагается заданным первыми 2 символами. Строка интерпретируется слева направо для определения значений года, месяца, дня, часа, минуты и секунды, постольку, поскольку такие части присутствуют в строке. Это означает, что вы не должны использовать строки, имеющие менее 6 символов. Например, если вы укажете '9903', предполагая, что это март 1999 года, MySQL преобразует его в значение даты “ноль”. Это происходит потому, что значения года и месяца — 99 и 03, но часть дня отсутствует. Однако вы можете явно указать значение ноль для обозначения отсутствующих частей месяца или дня. Например, чтобы вставить значение '1999-03-00', используйте '990300'.

MySQL распознаёт значения TIME в следующих форматах:

  • В виде строки в формате 'D hh:mm:ss'. Вы также можете использовать один из следующих “расслабленных” синтаксисов: 'hh:mm:ss', 'hh:mm', 'D hh:mm', 'D hh' или 'ss'. Здесь D представляет дни и может принимать значения от 0 до 34.

  • В виде строки без разделителей в формате 'hhmmss', при условии, что это имеет смысл как время. Например, '101112' понимается как '10:11:12', но '109712' некорректно (имеет бессмысленную часть минут) и становится '00:00:00'.

  • В виде числа в формате hhmmss, при условии, что это имеет смысл как время. Например, 101112 понимается как '10:11:12'. Также понимаются следующие альтернативные форматы: ss, mmss или hhmmss.

Конечная часть дробных секунд распознаётся в форматах времени 'D hh:mm:ss.fraction', 'hh:mm:ss.fraction', 'hhmmss.fraction' и hhmmss.fraction, где fraction — это дробная часть с точностью до микросекунд (6 цифр). Дробная часть всегда должна быть отделена от остальной части времени десятичной точкой; другие разделители дробных секунд не распознаются. Сведения о поддержке дробных секунд в MySQL см. в Разделе 13.2.6, «Дробные секунды во временных значениях».

Для значений TIME, заданных строками, содержащими разделители частей времени, нет необходимости указывать две цифры для значений часов, минут или секунд, которые меньше 10. '8:3:2' эквивалентно '08:03:02'.

При вставке значений TIMESTAMP и DATETIME в таблицу можно указать смещение часового пояса. Смещение добавляется к части времени временной метки без промежуточных пробелов и использует тот же формат, что и для установки системной переменной time_zone, за исключением следующих моментов:

  • Для значений часов меньше 10 требуется ведущий ноль.

  • Значение '-00:00' отклоняется.

  • Имена часовых поясов, такие как 'EET' и 'Asia/Shanghai', использовать нельзя; 'SYSTEM' также нельзя использовать в этом контексте.

Вставляемое значение не должно содержать ноль для части месяца, части дня или обеих частей. Это выполняется независимо от настройки серверного режима SQL.

В этом примере показано вставка значений datetime с часовыми смещениями в столбцы TIMESTAMP и DATETIME с использованием различных настроек time_zone, а затем их извлечение: 

mysql> CREATE TABLE ts (
    ->     id INTEGER NOT NULL AUTO_INCREMENT PRIMARY KEY,
    ->     col TIMESTAMP NOT NULL
    -> ) AUTO_INCREMENT = 1;

mysql> CREATE TABLE dt (
    ->     id INT NOT NULL AUTO_INCREMENT PRIMARY KEY,
    ->     col DATETIME NOT NULL
    -> ) AUTO_INCREMENT = 1;

mysql> SET @@time_zone = 'SYSTEM';

mysql> INSERT INTO ts (col) VALUES ('2020-01-01 10:10:10'),
    ->     ('2020-01-01 10:10:10+05:30'), ('2020-01-01 10:10:10-08:00');

mysql> SET @@time_zone = '+00:00';

mysql> INSERT INTO ts (col) VALUES ('2020-01-01 10:10:10'),
    ->     ('2020-01-01 10:10:10+05:30'), ('2020-01-01 10:10:10-08:00');

mysql> SET @@time_zone = 'SYSTEM';

mysql> INSERT INTO dt (col) VALUES ('2020-01-01 10:10:10'),
    ->     ('2020-01-01 10:10:10+05:30'), ('2020-01-01 10:10:10-08:00');

mysql> SET @@time_zone = '+00:00';

mysql> INSERT INTO dt (col) VALUES ('2020-01-01 10:10:10'),
    ->     ('2020-01-01 10:10:10+05:30'), ('2020-01-01 10:10:10-08:00');

mysql> SET @@time_zone = 'SYSTEM';

mysql> SELECT @@system_time_zone;
+--------------------+
| @@system_time_zone |
+--------------------+
| EST                |
+--------------------+

mysql> SELECT col, UNIX_TIMESTAMP(col) FROM dt ORDER BY id;
+---------------------+---------------------+
| col                 | UNIX_TIMESTAMP(col) |
+---------------------+---------------------+
| 2020-01-01 10:10:10 |          1577891410 |
| 2019-12-31 23:40:10 |          1577853610 |
| 2020-01-01 13:10:10 |          1577902210 |
| 2020-01-01 10:10:10 |          1577891410 |
| 2020-01-01 04:40:10 |          1577871610 |
| 2020-01-01 18:10:10 |          1577920210 |
+---------------------+---------------------+

mysql> SELECT col, UNIX_TIMESTAMP(col) FROM ts ORDER BY id;
+---------------------+---------------------+
| col                 | UNIX_TIMESTAMP(col) |
+---------------------+---------------------+
| 2020-01-01 10:10:10 |          1577891410 |
| 2019-12-31 23:40:10 |          1577853610 |
| 2020-01-01 13:10:10 |          1577902210 |
| 2020-01-01 05:10:10 |          1577873410 |
| 2019-12-31 23:40:10 |          1577853610 |
| 2020-01-01 13:10:10 |          1577902210 |
+---------------------+---------------------+

Смещение не отображается при выборке значения datetime, даже если оно использовалось при его вставке.

Диапазон поддерживаемых значений смещения составляет от -13:59 до +14:00 включительно.

Литералы datetime, включающие часовые смещения, принимаются в качестве значений параметров подготовленными операторами.

© 2025 Oracle
Licensed under the GPLv2 License.
https://docs.oracle.com/cd/E17952_01/mysql-9.2-en/date-and-time-literals.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API