Функции (дата, время)
Вы можете использовать нашего GPT-ассистента для помощи с операторами Nodul:
Он поможет с написанием выражений, использованием переменных, фильтров и построением логики внутри сценариев.
Алгоритм
Операторы этой группы обеспечивают выполнение логических операций с операндами типа дата/время. Результатом операций является дата.
Результат
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.
Совет:
Используйте эту комбинацию, если:
- Начальное значение даты предоставлено в виде строки.
- Вам нужно преобразовать строку в значение даты и отформатировать её в требуемый формат.