Прибавить секунды к дате SqlHelper::addSecondsToDateTime

Модуль: main — подключать отдельно не нужно

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

Метод SqlHelper::addSecondsToDateTime возвращает SQL-выражение, которое прибавляет число секунд к дате и времени. Отрицательное число вычитает секунды.

Сигнатура метода в классе Bitrix\Main\DB\SqlHelper:

abstract public function addSecondsToDateTime($seconds, $from = null);

Параметры

Обязательные параметры обозначены *

Параметр Тип Описание
seconds* int Задает число секунд. Метод подставляет значение в SQL без экранирования, приведите его к целому числу заранее
from string, null Задает колонку или SQL-выражение с датой и временем. Метод подставляет значение в SQL без экранирования. По умолчанию — null, текущие дата и время

Типы в таблице описывают назначение аргументов. Сигнатура PHP не объявляет их.

Возвращаемое значение

Метод возвращает строку string — SQL-выражение.

Реализация Выражение
MysqliSqlHelper DATE_ADD(<from>, INTERVAL <seconds> SECOND). Без from — NOW()
PgsqlSqlHelper <from>::timestamp + cast(<seconds>||' second' as interval). Без from — now()

Примеры

Пример. Код считает пользователей, которые входили на сайт за последний час:

<?php
use Bitrix\Main\Application;
use Bitrix\Main\UserTable;

require $_SERVER['DOCUMENT_ROOT'] . '/bitrix/modules/main/include/prolog_before.php';

$connection = Application::getConnection();
$helper = $connection->getSqlHelper();

echo $connection->queryScalar(
    'SELECT COUNT(*) FROM ' . $helper->quote(UserTable::getTableName())
    . ' WHERE LAST_LOGIN > ' . $helper->addSecondsToDateTime(-3600)
);

Смотрите также