Перейти к основному содержимому

07.6 Функции (время, даты)

Алгоритм​

Операторы этой группы обеспечивают выполнение логических операций с операндами типа дата/время. Результатом выполнения операций является дата.

Примеры​

addMinutes​

Генерирует новое значение даты:

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

Пример: Если 3.ValueSV = 2023-01-01T00:00:00Z, то 2023-01-01T00:05:00Z.

  • отнимая от текущего значения даты заданное количество минут, если указано отрицательное значение.

Пример: Если 3.ValueSV = 2023-01-01T00:25:00Z, то 2023-01-01T00:20:00Z.

addHours​

Генерирует новое значение даты:

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

Пример: Если 3.ValueSV = 2023-01-01T00:00:00Z, то 2023-01-01T10:00:00Z.

  • отнимая от текущего значения даты заданное количество часов, если указано отрицательное значение.

Пример: Если 3.ValueSV = 2023-01-01T12:00:00Z, то 2023-01-01T04:00:00Z.

addDays​

Генерирует новое значение даты:

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

Пример: Если 3.ValueSV = 2023-01-01T00:00:00Z, то 2023-01-02T00:00:00Z.

  • отнимая от текущего значения даты заданное количество дней, если указано отрицательное значение.

Пример: Если 3.ValueSV = 2023-01-01T00:00:00Z, то 2022-12-29T00:00:00Z.

addMonths​

Генерирует новое значение даты:

  • прибавляя к текущему значению даты заданное количество месяцев, если указано положительное значение;

Пример: Если 3.ValueSV = 2023-01-01T00:00:00Z, то 2023-05-01T00:00:00Z.

  • отнимая от текущего значения даты заданное количество месяцев, если указано отрицательное значение.

Пример: Если 3.ValueSV = 2023-01-01T00:00:00Z, то 2021-12-01T00:00:00Z.

setMinute​

Генерирует новое значение даты, заменяя минуты текущей даты на заданное значение.

Пример: Если 3.ValueSV = 2023-01-31T11:11:00Z, то 2023-01-31T11:05:00Z.

setHour​

Генерирует новое значение даты, заменяя часы текущей даты на заданное значение.

Пример: Если 3.ValueSV = 2023-01-31T11:11:00Z, то 2023-01-31T05:11:00Z.

setDay​

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

подсказка

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

  • Пример: Если 3.ValueSV = 2023-09-03T00:00:00Z, то 2023-09-10T00:00:00Z.
  • Пример: Если 3.ValueSV = 2023-09-03T00:00:00Z, то 2023-09-04T00:00:00Z.

formatDate​

Возвращает дату в запрошенном формате и в указанном часовом поясе, если он указан.

подсказка

Список таймзон можно найти тут.

Пример: Если 3.ValueSV = 2023-09-03T00:00:00Z, то 03.09.2023 03:00.

parseDate​

Преобразует строку в дату запрошенного формата.

Пример: Если 3.ValueSV = 2023-09-03, то 2023-09-03T00:00:00Z.

Комбинация parseDate и formatDate​

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

Пример: Если 3.ValueSV = "2030-03-14 08:45:12" (строка), для преобразования в формат DD.MM.YYYY HH:mm:ss используется следующая конструкция:

Результат: 14.03.2030 08:45:12.

Подсказка:

Используйте эту комбинацию, если:

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