Группа: Конвертация дат
Подгруппа: -
Последняя версия: 7 (.NET)
Описание
Действие преобразует текстовое значение в объект «Дата и время». Для корректного распознавания данных необходимо указать один или список возможных шаблонов (масок). Если входная строка не соответствует ни одному из заданных форматов или содержит несуществующую дату, выполнение действия прерывается с ошибкой.
Применение
- Получить дату и/или время в виде строки.
- Конвертировать значение в системный формат действием «Преобразовать дату в строку».
- Использовать полученное значение с типом «Дата-время» в других действиях.
Изменения в версии
- изменена логика действия: теперь действие учитывает несколько форматов входных данных, по которым проходится последовательно до получения валидного результата.
- изменено описание действия;
- изменены названия параметров, описания;
- добавлена обработка ошибок.
Параметры и их настройки
Свойство | Описание | Тип | Пример | Обязательность |
|---|---|---|---|---|
| Параметры | ||||
| Исходная строка | Текстовое значение даты и/или времени (тип «Строка»), которое необходимо преобразовать в объект «Дата и время». | Строка | 10.03.2026 12:00:00 | Да |
| Формат даты и времени | Укажите формат даты и времени в исходной строке. Клонируемый параметр: если данные могут поступать в нескольких пользовательских форматах, создайте дополнительное поле для каждого нового шаблона. Примеры:
Важно:
| Строка | dd.MM.yyyy HH:mm:ss | Да |
| Результаты | ||||
| Результат | Переменная типа «Дата и время», в которую сохраняется результат преобразования параметра «Исходная строка». | Дата-время | - | - |
Особые условия использования
- Если в «Исходной строке» полностью отсутствует блок даты (передано только время), дата в «Результате» должна быть обнулена до минимального значения (0001-01-01). Если полностью отсутствует блок времени (передана только дата), время в «Результате» должно быть обнулено (00:00:00).
- Если в параметре «Исходная строка» дата указана частично (без года), будет использован текущий календарный год системы. При обработке «29 февраля» используемый год проверяется на високосность.
- Перебор шаблонов в параметре «Формат даты и времени» выполняется строго в порядке их добавления пользователем (сверху вниз).
Версии