Часто при работе 1С со сторонними информационными системами (например, при парсинге сайтов) необходимо из строковой переменной получить дату. Когда одна 1С общается с другой, такой проблемы при грамотной архитектуре не возникает. Разберем, как можно конвертировать значение строкового типа в дату.
Функция Дата() для преобразования строки в дату в 1С
Для преобразования строки в дату используют функцию Дата(). Эта функция имеет два варианта синтаксиса.
Первый вариант синтаксиса - передать строку с локальном формате даты. Обязательно с указанием года из четырех цифр, месяца из двух цифр, даты из двух цифр, далее часа из двух цифр, аналогично минут и секунд. Формат этот можно представить так: "ГГГГММДДччммсс".
Второй вариант синтаксиса - передать в параметрах функции Дата() информацию о годе, месяце, дне, часе, минутах и секундах через запятую. Все шесть переменных должны быть числового формата.
Информацию из синтакс-помощника с примерами конвертации читайте в конце статьи.
Функция СтрокаВДату() из БСП для конвертации строки в дату по формату
Плохо, что в платформе 1С нет стандартной функции для преобразования строки в дату. Такая функция нужна, т.к. чаще всего дата в виде строки, полученная парсингом сайта или из других информационных систем, выглядит так: “21.07.2025”. И вот чтобы ее превратить в дату с помощью функции Дата(), нужно долго разбивать строку точками на день, месяц, год, потом конвертировать в число и потом передавать в функцию Дата(). Необходимо более простой инструмент.
Быстро конвертируйте в дату с помощью функции БСП СтрокаВДату().
В некоторых версиях БСП функция находится в общем модуле СтроковыеФункцииКлиентСервер, а в других - в ОбщегоНазначенияКлиентСервер. Определяйте имя общего модуля в своем случае самостоятельно.
Пример вызова может выглядеть так:
Результат = СтроковыеФункцииКлиентСервер.СтрокаВДату(МояСтрока);
Или так:
Результат = ОбщегоНазначенияКлиентСервер.СтрокаВДату(Значение)
А если в конфигурации 1С нет БСП?
В этом случае можете добавить код функции СтрокаВДату() и вызывать ее из кода. Программный код может выглядеть следующим образом:
// Преобразует исходную строку в дату.
//
// Параметры:
// ДатаСтрока - Строка - Строка, которую необходимо привести к дате.
//
// Возвращаемое значение:
// Дата - Полученная дата.
//
Функция СтрокаВДату(Знач ДатаСтрока) Экспорт
ПозицияПробела = СтрНайти(ДатаСтрока, " ", НаправлениеПоиска.СНачала);
Если ПозицияПробела > 0 Тогда
ДатаСтрока = Лев(ДатаСтрока, ПозицияПробела - 1);
КонецЕсли;
ДатаСтрока = СокрЛП(СтрЗаменить(ДатаСтрока, ".", ""));
ДатаСтрока = Сред(ДатаСтрока, 5) + Сред(ДатаСтрока, 3, 2) + Лев(ДатаСтрока, 2);
Если СтрДлина(ДатаСтрока) = 6 Тогда
ДатаСтрока = "20" + ДатаСтрока;
КонецЕсли;
ОписаниеТипа = Новый ОписаниеТипов("Дата");
Результат = ОписаниеТипа.ПривестиЗначение(ДатаСтрока);
Возврат Результат;
КонецФункции
Когда формат отличается от “DD.MM.YYYY”, есть синтаксис с указанием формата даты. В этом случае код функции выглядит следующим образом:
//Преобразование строки в дату/время с указанием строки форматирования.
//При ошибке преобразования генерируется исключение.
//Допустимые значения в строке форматирования:
// yyyy - год полностью
// yy - год сокращённо
// mm - месяц
// dd - день
// hh - часы
// nn - минуты
// ss - секунды
// Разделитель в исходной строке и строке форматирования может различаться.
//
// Параметры:
// ДатаСтрока - Строка - Исходная строка с датой
// ФорматДаты - Строка - Формат даты в переданной строке
//
// Возвращаемое значение:
// Дата
//
// Пример:
// СтрокаВДатуВремя("02.06.22", "dd.mm.yy")
// СтрокаВДатуВремя("02.06.22 12:30:00, "dd.mm.yy hh:nn:ss")
// СтрокаВДатуВремя("02/06/22 12:30:00, "dd.mm.yy hh:nn:ss")
Функция СтрокаВДатуВремя(ДатаСтрока, ФорматДаты = "dd.mm.yyyy") Экспорт
Если ЗначениеЗаполнено(ДатаСтрока) Тогда
Попытка
Годы = СтрНайти(ФорматДаты, "yyyy");
Годы = ?(Годы = 0 , 0, Число(Сред(ДатаСтрока, Годы, 4)));
Если Годы = 0 Тогда
Годы = СтрНайти(ФорматДаты, "yy");
Годы = ?(Годы = 0 , 0, Число("20" + Сред(ДатаСтрока, Годы, 2)));
КонецЕсли;
Месяцы = СтрНайти(ФорматДаты, "mm");
Дни = СтрНайти(ФорматДаты, "dd");
Часы = СтрНайти(ФорматДаты, "hh");
Минуты = СтрНайти(ФорматДаты, "nn");
Секунды = СтрНайти(ФорматДаты, "ss");
Возврат Дата(
?(Годы = 0, 1, Годы),
?(Месяцы = 0, 1, Число(Сред(ДатаСтрока, Месяцы, 2))),
?(Дни = 0, 1, Число(Сред(ДатаСтрока, Дни, 2))),
?(Часы = 0, 0, Число(Сред(ДатаСтрока, Часы, 2))),
?(Минуты = 0, 0, Число(Сред(ДатаСтрока, Минуты, 2))),
?(Секунды = 0, 0, Число(Сред(ДатаСтрока, Секунды, 2)))
)
Исключение
ВызватьИсключение "Ошибка преобразования строки """ + ДатаСтрока + """ в дату по формату """ + ФорматДаты + """"
КонецПопытки;
Иначе
Возврат Неопределено
КонецЕсли;
КонецФункции // СтрокаВДатуВремя
Информация про функцию Дата() из синтакс-помощника
Глобальный контекст (Global context)
Дата (Date)
Вариант синтаксиса: По строке
Синтаксис:
Дата(<Значение>)
Параметры:
<Значение> (обязательный)
Тип: Строка.
Исходное значение даты.
Строка должна содержать дату в локальном формате даты или в каноническом виде YYYYMMDDHHMMSS.
Описание варианта метода:
При преобразовании строка должна содержать дату в каноническом формате "ГГГГММДДччммсс" (см. раздел "Примитивные типы данных").
Вариант синтаксиса: По составляющим
Синтаксис:
Дата(<Год>, <Месяц>, <День>, <Час>, <Минута>, <Секунда>)
Параметры:
<Год> (обязательный)
Тип: Число.
Год даты.
<Месяц> (обязательный)
Тип: Число.
Месяц даты.
<День> (обязательный)
Тип: Число.
День даты.
<Час> (необязательный)
Тип: Число.
Час даты.
<Минута> (необязательный)
Тип: Число.
Минута даты.
<Секунда> (необязательный)
Тип: Число.
Секунда даты.
Описание варианта метода:
Допускаются следующие формы задания параметров:
- Дата(Год, Месяц, День);
- Дата(Год, Месяц, День, Час, Минута, Секунда);
Возвращаемое значение:
Тип: Дата.
Описание:
Преобразует полученный параметр (параметры) в значение типа Дата.
Доступность:
Тонкий клиент, веб-клиент, мобильный клиент, сервер, толстый клиент, внешнее соединение, мобильное приложение (клиент), мобильное приложение (сервер), мобильный автономный сервер.
Внимание: Данный метод не поддерживается при работе через COM-соединение
Для преобразования строки в дату в 1С можно использовать функцию «Дата()».
Вариант 1: преобразование по строке. Строка должна содержать дату в локальном формате или в каноническом виде YYYYMMDDHHMMSS. Пример: Дата("20211231123456").
Вариант 2: преобразование по составляющим частям. Если известны составные части даты — год, месяц, день и т. д., можно использовать конструктор даты по составляющим. Задавать параметры можно как в виде строки, так и числом. Пример: Дата("2021", "12", "24", "12", "34", "56").
Также для преобразования строки в дату в 1С можно использовать функцию СтрокаВДату(Строка, Формат), которая преобразует строку в значение типа Дата в соответствии с заданным форматом.
