Вычислить дату

Описание

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

Описание параметров

Блок имеет ряд параметров:

1. Дата - исходная дата или время, относительно которых выполняется вычисление.

   Тип данных: str (Строка) | datetime (Объект даты)

   Пример: 31.12.2023 23:59:59

2. Действие - операция над датой. Доступные значения: прибавить, вычесть.

   Тип данных: dropdown (Выпадающий список)

   Пример: прибавить

3. Единица измерения времени - тип интервала. Доступные значения: год, месяц, день, час, минута, секунда.

   Тип данных: dropdown (Выпадающий список)

   Пример: год

4. Количество - число единиц времени, которое нужно прибавить или вычесть.

   Тип данных: int (Целое число)

   Пример: 1

5. Вернуть в формате - формат результата. Блок поддерживает строковые форматы даты и времени, а также вариант объект даты (datetime). Доступные форматы:

   • YYYY-MM-DD
   • YYYYMMDD
   • YYYY/MM/DD
   • DD-MM-YYYY
   • DD.MM.YYYY
   • DD.MM.YY
   • DD/MM/YYYY
   • YYYY-MM-DD HH:mm:ss
   • YYYY/MM/DD HH:mm:ss
   • DD.MM.YYYY HH:mm:ss
   • DD/MM/YYYY HH:mm:ss
   • DD month YYYY
   • HH:mm:ss
   • HHmmss
   • HH:mm
   • HHmm
   • объект даты (datetime)

Требования

Если выбран формат объект даты (datetime), блок вернет объект datetime, а не строку.

---

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

Блок возвращает рассчитанную дату:

Тип данных: str (Строка) | datetime (Объект даты)

Пример: 2024-01-01 00:00:00

---

Пример использования

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

1. Добавить в алгоритм блок Вычислить дату.

2. Указать исходную дату.

3. Выбрать действие, единицу измерения времени и количество.

4. Указать формат, в котором нужно вернуть результат.

   

---

Результат

Блок вернет новую дату, рассчитанную с учетом выбранного действия и интервала.