TIMESTAMP и DATETIME столбцы могут быть автоматически инициализированы и обновлены до текущей даты и времени (то есть текущей метки времени).

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

Кроме того, если переменная сервера explicit_defaults_for_timestamp отключена, можно инициализировать или обновить любой столбец типа TIMESTAMP (но не DATETIME) до текущей даты и времени, присвоив ему значение NULL, если он не был определён с атрибутом NULL, разрешающим значения NULL.

Для указания автоматических свойств используйте клаузы DEFAULT CURRENT_TIMESTAMP и ON UPDATE CURRENT_TIMESTAMP в определениях столбцов. Порядок клаузов не имеет значения. Если обе клаузы присутствуют в определении столбца, любая из них может стоять первой. Любой из синонимов функции CURRENT_TIMESTAMP имеет то же значение, что и CURRENT_TIMESTAMP. К ним относятся CURRENT_TIMESTAMP(), NOW(), LOCALTIME, LOCALTIME(), LOCALTIMESTAMP и LOCALTIMESTAMP().

Использование DEFAULT CURRENT_TIMESTAMP и ON UPDATE CURRENT_TIMESTAMP специфично для TIMESTAMP и DATETIME. Клауза DEFAULT также может быть использована для задания постоянного (неавтоматического) значения по умолчанию (например, DEFAULT 0 или DEFAULT '2000-01-01 00:00:00').

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

Столбцы типа TIMESTAMP и DATETIME не имеют автоматических свойств, если они не указаны явно, за исключением этого случая: если переменная сервера explicit_defaults_for_timestamp отключена, первый столбец типа TIMESTAMP имеет и DEFAULT CURRENT_TIMESTAMP, и ON UPDATE CURRENT_TIMESTAMP, если ни то, ни другое не указано явно. Чтобы подавить автоматические свойства для первого столбца типа TIMESTAMP, используйте одну из этих стратегий:

Рассмотрим эти определения таблиц:

CREATE TABLE t1 (
  ts1 TIMESTAMP DEFAULT 0,
  ts2 TIMESTAMP DEFAULT CURRENT_TIMESTAMP
                ON UPDATE CURRENT_TIMESTAMP);
CREATE TABLE t2 (
  ts1 TIMESTAMP NULL,
  ts2 TIMESTAMP DEFAULT CURRENT_TIMESTAMP
                ON UPDATE CURRENT_TIMESTAMP);
CREATE TABLE t3 (
  ts1 TIMESTAMP NULL DEFAULT 0,
  ts2 TIMESTAMP DEFAULT CURRENT_TIMESTAMP
                ON UPDATE CURRENT_TIMESTAMP);

Таблицы имеют следующие свойства:

Если определение столбца типа TIMESTAMP или DATETIME включает явное значение точности дробных секунд в любом месте, то это же значение должно использоваться во всём определении столбца. Это разрешено:

CREATE TABLE t1 (
  ts TIMESTAMP(6) DEFAULT CURRENT_TIMESTAMP(6) ON UPDATE CURRENT_TIMESTAMP(6)
);

Это запрещено:

CREATE TABLE t1 (
  ts TIMESTAMP(6) DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP(3)
);

Инициализация TIMESTAMP и атрибут NULL

Если системная переменная explicit_defaults_for_timestamp отключена, столбцы типа TIMESTAMP по умолчанию содержат NOT NULL, не могут содержать NULL значения, а присваивание NULL устанавливает текущую метку времени. Чтобы разрешить столбцу TIMESTAMP содержать NULL, явно укажите его с атрибутом NULL. В этом случае значение по умолчанию также становится NULL, если не переопределено с помощью клаузы DEFAULT, которая задает другое значение по умолчанию. DEFAULT NULL можно использовать для явного задания NULL в качестве значения по умолчанию. (Для столбца TIMESTAMP, не объявленного с атрибутом NULL, DEFAULT NULL недействительно.) Если столбец TIMESTAMP допускает значения NULL, присваивание NULL устанавливает его в NULL, а не в текущую метку времени.

В следующей таблице содержатся несколько столбцов TIMESTAMP, которые допускают значения NULL:

CREATE TABLE t
(
  ts1 TIMESTAMP NULL DEFAULT NULL,
  ts2 TIMESTAMP NULL DEFAULT 0,
  ts3 TIMESTAMP NULL DEFAULT CURRENT_TIMESTAMP
);

Столбец TIMESTAMP, который допускает значения NULL, не принимает текущую метку времени во время вставки, за исключением следующих условий:

Другими словами, столбец TIMESTAMP, определенный для допуска значений NULL, автоматически инициализируется только в том случае, если его определение включает DEFAULT CURRENT_TIMESTAMP:

CREATE TABLE t (ts TIMESTAMP NULL DEFAULT CURRENT_TIMESTAMP);

Если столбец TIMESTAMP допускает значения NULL, но его определение не включает DEFAULT CURRENT_TIMESTAMP, вы должны явно вставить значение, соответствующее текущей дате и времени. Предположим, что таблицы t1 и t2 имеют следующие определения:

CREATE TABLE t1 (ts TIMESTAMP NULL DEFAULT '0000-00-00 00:00:00');
CREATE TABLE t2 (ts TIMESTAMP NULL DEFAULT NULL);

Чтобы установить столбец TIMESTAMP в любой таблице на текущую метку времени при вставке, явно присвойте ему это значение. Например:

INSERT INTO t2 VALUES (CURRENT_TIMESTAMP);
INSERT INTO t1 VALUES (NOW());

Если системная переменная explicit_defaults_for_timestamp включена, столбцы TIMESTAMP допускают значения NULL только если объявлены с атрибутом NULL. Кроме того, столбцы TIMESTAMP не допускают присваивание NULL для присваивания текущей метки времени, независимо от того, объявлены они с атрибутом NULL или NOT NULL. Чтобы присвоить текущую метку времени, установите столбец в CURRENT_TIMESTAMP или синоним, такой как NOW().