EXPIREAT

EXPIREAT

EXPIREAT key unix-time-seconds [NX | XX | GT | LT]

Доступно с версии:

1.2.0

Сложность вычислений:

O(1)

Категории ACL:

@keyspace, @write, @fast,

EXPIREAT имеет тот же эффект и семантику, что и EXPIRE, но вместо указания количества секунд, представляющих TTL (время жизни), она принимает абсолютную временную метку Unix (секунды с 1 января 1970 года). Временная метка в прошлом приведет к немедленному удалению ключа.

Для получения подробной информации о семантике команды обратитесь к документации EXPIRE.

Описание

EXPIREAT была введена для преобразования относительных таймаутов в абсолютные таймауты для режима сохранения AOF. Конечно, ее можно использовать непосредственно для указания того, что данный ключ должен истечь в определенное время в будущем.

Параметры

Команда EXPIREAT поддерживает набор параметров:

• NX -- Установить срок действия только если у ключа нет срока действия
• XX -- Установить срок действия только если у ключа уже есть срок действия
• GT -- Установить срок действия только если новый срок действия больше текущего
• LT -- Установить срок действия только если новый срок действия меньше текущего

Неизменяемый ключ рассматривается как бесконечный TTL для целей GT и LT. Параметры GT, LT и NX являются взаимоисключающими.

Возврат

Целочисленный ответ, а именно:

• 1 если таймаут был установлен.
• 0 если таймаут не был установлен. Например, ключ не существует или операция была пропущена из-за предоставленных аргументов.

Примеры

SET mykey "Hello"
EXISTS mykey
EXPIREAT mykey 1293840000
EXISTS mykey

История

• Начиная с версии Redis 7.0.0: Добавлены параметры: NX, XX, GT и LT.