Системные переменные времени

Что это такое

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

Например, если вашему тесту нужна "завтрашняя дата" или "время через 2 часа", достаточно один раз настроить переменную — и она всегда будет актуальной при каждом запуске теста.

Когда это нужно

Системные переменные времени особенно полезны в случаях:

• Когда нужно ввести актуальную дату или время в поле — например, дату завершения задачи, время встречи, период действия документа. Переменная подставит актуальное значение, и вам не придётся каждый раз обновлять тест-кейс вручную.

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

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

Типы переменных

В справочнике переменных теперь поддерживаются два типа переменных, которые вы увидите при создании:

Простая переменная (Simple)

Это обычная переменная, в которую вы вводите любое значение: текст, число, URL. Значение остаётся неизменным, пока вы сами его не отредактируете.

Подробнее про создание simple переменных.

Переменная времени (Time)

Это системная переменная, которая автоматически вычисляется на основе текущей даты и времени. Вы настраиваете правила вычисления один раз, а система подставляет актуальное значение при каждом запуске теста.

Пример: переменная current_date_time, которая всегда возвращает завтрашнюю дату относительно текущей.

Создание переменной времени

Открытие формы создания

1. Откройте нужный набор переменных в разделе Variables.

2. Нажмите кнопку «+Variable».

3. В открывшейся форме выберите тип «Time».

После выбора типа "Time" появится специальный конструктор для настройки вычисления даты.

Заполнение основных полей

Укажите название и описание переменной:

• Variable name — имя переменной, которое вы будете использовать в шагах тест-кейса. Например, deadlineDate, startTime, tomorrowDate.

• Description — опциональное поле для пояснения, зачем нужна эта переменная. Например, "Дедлайн задачи через 2 дня".

Настройка вычисления времени

Конструктор переменных времени состоит из нескольких шагов, которые применяются последовательно. Вы выбираете базовую точку отсчёта, затем можете применить к ней различные модификации.

Шаг 1: Выбор базовой переменной

Это отправная точка для вычислений — момент времени, от которого будут отсчитываться все изменения.

В выпадающем списке «Base variable» выберите один из вариантов:

• Current date — сегодняшняя дата без времени

• Current time — текущее время без даты

• Current date and time — полная временная метка с датой и временем

• Unix timestamp — количество секунд с 1 января 1970 года

• Today — то же самое, что "Текущая дата"

• Yesterday — вчерашняя дата

• Tomorrow — завтрашняя дата

• Start of day — сегодняшняя дата в 00:00:00

• End of day — сегодняшняя дата в 23:59:59

Шаг 2: Добавление сдвигов времени (опционально)

Сдвиги позволяют добавить или вычесть определённый период времени. Например, "через 2 дня" или "минус 30 минут".

1. Нажмите кнопку «+ Add Shift».

2. Появится строка с двумя полями:

   • Значение— сколько единиц времени добавить или вычесть (положительное или отрицательное)

   • Единица измерения — выберите из списка: секунды, минуты, часы, дни, месяцы, годы

3. Для удаления сдвига нажмите иконку корзины справа от строки.

4. Вы можете добавить несколько сдвигов — они применяются последовательно.

Примеры:

• +2 дня, +8 часов → через 2 дня и 8 часов

• +1 месяц, -1 день → через месяц минус один день (последний день текущего месяца через месяц)

• -30 минут → 30 минут назад

Шаг 3: Указание часового пояса (опционально)

Если ваше приложение работает в определённом часовом поясе, отличном от серверного, вы можете указать его явно.

1. Установите галочку «Use timezone».

2. В появившемся выпадающем списке выберите нужный пояс:

   • UTC+0 (Лондон)

   • UTC+3 (Москва)

   • UTC+5:30 (Индия)

   • UTC-5 (Нью-Йорк)

   • и другие

Шаг 4: Форматирование вывода (опционально)

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

1. Установите галочку «Use format».

2. В выпадающем списке выберите один из популярных форматов:

   • YYYY-MM-DD → 2025-11-04

   • DD.MM.YYYY → 04.11.2025

   • YYYY-MM-DD HH:mm:ss → 2025-11-04 14:30:45

   • HH:mm:ss → 14:30:45

   • X → Unix секунды (1730716800)

   • x → Unix миллисекунды (1730716800000)

   • Пользовательский формат → введите свой

3. Если выбрали "Пользовательский формат", появится текстовое поле для ручного ввода.

Доступные элементы формата:

Шаг 5: Режим вычисления

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

Установите галочку «Calculate once (constant)», если хотите, чтобы значение вычислялось один раз в начале запуска тест-кейса и оставалось неизменным до конца его выполнения.

Если галочка не установлена, переменная будет динамической — её значение пересчитывается перед исполнением шага в котором она указана.

Когда использовать константу:

• Вам нужна одна и та же дата/время на протяжении всего теста

• Вы заполняете форму с дедлайном, который должен быть одинаковым в нескольких полях

• Ваш тест проверяет согласованность данных по времени

Когда использовать динамическое значение:

• Тест длительный, и время должно обновляться между шагами

• Вы проверяете актуальность данных "прямо сейчас"

• Нужно зафиксировать или проверить время для нескольких действий в динамике (например, время создания и время изменения записи)

Предпросмотр значения

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

Предпросмотр обновляется в реальном времени при изменении любых параметров: базовой переменной, сдвигов, часового пояса или формата.

Сохранение переменной

После заполнения всех полей нажмите кнопку «Create» или «Save» (в зависимости от того, создаёте вы новую переменную или редактируете существующую).

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

Отображение в справочнике

После создания переменная отображается в таблице со следующими колонками:

Для переменных типа "Время" рядом со значением отображается дополнительный бейдж:

• Const — значение вычисляется один раз при запуске тест-кейса

• Dynamic — значение пересчитывается перед каждым шагом

Использование в тест-кейсах

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

Более подробно об этом можно прочитать в статье про переменные.