Класс yii\behaviors\TimestampBehavior

TimestampBehavior автоматически заполняет указанные атрибуты текущим отметкой времени.

Для использования TimestampBehavior добавьте следующий код в свой класс ActiveRecord:

use yii\behaviors\TimestampBehavior;

public function behaviors()
{
    return [
        TimestampBehavior::className(),
    ];
}

По умолчанию, TimestampBehavior заполнит атрибуты created_at и updated_at текущей отметкой времени при вставке связанного объекта AR; атрибут updated_at будет заполнен отметкой времени при обновлении объекта AR. Значение отметки времени получается с помощью time().

Так как значения атрибутов будут автоматически устанавливаться этим поведением, они обычно не являются вводом пользователя и, следовательно, не должны подвергаться валидации, т.е. created_at и updated_at не должны появляться в методе rules() модели.

Для работы с базой данных MySQL необходимо объявить столбцы (created_at, updated_at) как int(11) для хранения UNIX-временной метки.

Если имена атрибутов отличаются или требуется использовать другой способ вычисления отметки времени, можно настроить свойства $createdAtAttribute, $updatedAtAttribute и $value следующим образом:

use yii\db\Expression;

public function behaviors()
{
    return [
        [
            'class' => TimestampBehavior::className(),
            'createdAtAttribute' => 'create_time',
            'updatedAtAttribute' => 'update_time',
            'value' => new Expression('NOW()'),
        ],
    ];
}

В случае использования объекта yii\db\Expression, как в примере выше, атрибут будет содержать не значение отметки времени, а сам объект Expression после сохранения записи. Если вам нужно получить значение из БД позже, вы должны вызвать метод refresh() записи.

TimestampBehavior также предоставляет метод touch(), позволяющий назначить текущую отметку времени указанному(ым) атрибуту(ам) и сохранить их в базе данных. Например,

$model->touch('creation_time');

Публичные свойства

Публичные методы

Защищенные методы

Подробности свойств

$createdAtAttribute публичное свойство

Атрибут, который получит значение отметки времени. Установите это свойство в false, если вы не хотите записывать время создания.

public string $createdAtAttribute = 'created_at'

$updatedAtAttribute публичное свойство

Атрибут, который получит значение отметки времени. Установите это свойство в false, если вы не хотите записывать время обновления.

public string $updatedAtAttribute = 'updated_at'

$value публичное свойство

Значение, которое будет назначено текущим атрибутам. Это может быть анонимная функция, вызываемая в формате массива (например, [$this, 'methodName']), объект Expression, представляющий выражение БД (например, new Expression('NOW()')), скаляр, строка или произвольное значение. Если функция, то возвращаемое значение функции будет назначено атрибутам. Подпись функции должна быть следующей,

function ($event)
{
    // return value will be assigned to the attribute
}

В случае, когда значение равно null, результат PHP-функции time() будет использоваться в качестве значения.

public mixed $value = null

Подробности методов

$model->touch('lastVisit');