Преобразовывает дату в строку для последующей записи в формат JSON. Если запись выполняется в формате ISO и в качестве варианта записи даты используется ЛокальнаяДатаСоСмещением, то в силу особенностей формата будут опущены секунды смещения местного времени относительно UTC. Пример: если смещение местного времени относительно UTC составляет 02:30:17, в результате смещение будет записано в виде: +02:30.
Синтаксис
ЗаписатьДатуJSON(<Дата>, <Формат>, <ВариантЗаписиДаты>)Полное описание, параметры и ограничения
Глобальный контекст.ЗаписатьДатуJSON (Global context.WriteJSONDate)
Глобальный контекст (Global context)
ЗаписатьДатуJSON (WriteJSONDate)
Доступен, начиная с версии 8.3.6.
Синтаксис:
ЗаписатьДатуJSON(<Дата>, <Формат>, <ВариантЗаписиДаты>)
Параметры:
<Дата> (обязательный)
Тип: Дата.
Дата, которую надо преобразовать в формат JSON.
<Формат> (обязательный)
Тип: ФорматДатыJSON.
Формат записываемой даты.
<ВариантЗаписиДаты> (необязательный)
Тип: ВариантЗаписиДатыJSON.
Указывает используемый вариант записи даты JSON.
Значение по умолчанию: ЛокальнаяДата.
Возвращаемое значение:
Тип: Строка.
Описание:
Преобразовывает дату в строку для последующей записи в формат JSON.
Если запись выполняется в формате ISO и в качестве варианта записи даты используется ЛокальнаяДатаСоСмещением, то в силу особенностей формата будут опущены секунды смещения местного времени относительно UTC.
Пример: если смещение местного времени относительно UTC составляет 02:30:17, в результате смещение будет записано в виде: +02:30.
Доступность:
Тонкий клиент, мобильный клиент, сервер, толстый клиент, внешнее соединение, мобильное приложение (клиент), мобильное приложение (сервер), мобильный автономный сервер.
Использование в версии:
Доступен, начиная с версии 8.3.6.
Описание изменено в версии 8.3.23.
Методическая информация
Практические примеры
Согласовать локальную календарную дату в формате JSON ISO
Записываем и читаем фиксированную локальную дату. Явно не выдаём её за момент UTC или за дату с заданным часовым поясом.
Где и как запускать
Учебная база: создайте серверный общий модуль УчебныеЗадачи (флаг Сервер). Код без директив вставьте в тело процедуры ВыполнитьПример() Экспорт. Вызовите её из серверного обработчика команды учебной обработки. Не запускайте в рабочей базе.
Подготовка
Все исходные JSON-строки и значения заданы в коде. Файлы, токены доступа, интернет и рабочая база не нужны.
Не подставляйте в упражнения ответы реального API с персональными данными. Сначала проверяйте неизменённый учебный набор.
Запись и обратное чтение выполняются в одном серверном контексте. Для этого упражнения выбран локальный календарный контракт без часового смещения.
ИсходнаяДата = Дата(2026, 9, 15, 10, 20, 30);
ТекстДаты = ЗаписатьДатуJSON(ИсходнаяДата, ФорматДатыJSON.ISO, ВариантЗаписиДатыJSON.ЛокальнаяДата);
ВосстановленнаяДата = ПрочитатьДатуJSON(ТекстДаты, ФорматДатыJSON.ISO);
Сообщить(ТекстДаты);
Сообщить(ВосстановленнаяДата = ИсходнаяДата);
Настройки = Новый НастройкиСериализацииJSON;
Настройки.ФорматСериализацииДат = ФорматДатыJSON.ISO;
Настройки.ВариантЗаписиДаты = ВариантЗаписиДатыJSON.ЛокальнаяДата;
Настройки.СериализовыватьМассивыКакОбъекты = Ложь;
Запись = Новый ЗаписьJSON;
Запись.УстановитьСтроку();
ЗаписатьJSON(Запись, Новый Структура("date", ИсходнаяДата), Настройки);
ТекстJSON = Запись.Закрыть();
Чтение = Новый ЧтениеJSON;
Чтение.УстановитьСтроку(ТекстJSON);
Попытка
Данные = ПрочитатьJSON(Чтение);
Исключение
Чтение.Закрыть();
ВызватьИсключение;
КонецПопытки;
Чтение.Закрыть();
Если ТипЗнч(Данные.date) <> Тип("Строка") Тогда
ВызватьИсключение "В обычном JSON дата должна была стать строкой";
КонецЕсли;
Сообщить(ПрочитатьДатуJSON(Данные.date, ФорматДатыJSON.ISO) = ИсходнаяДата);Разбор по шагам
Дата платформы не хранит часовой пояс. Явно выбираем ЛокальнаяДата, а не придумываем суффикс Z.
ЗаписатьДатуJSON возвращает строковое представление даты; сериализатор помещает такую строку в поле JSON.
Обычное ПрочитатьJSON возвращает поле date строкой. Для восстановления даты вызываем ПрочитатьДатуJSON отдельно.
При обмене моментами времени с API надо выбрать UTC или согласованный offset-контракт отдельной задачей.
Как проверить результат
Дата восстанавливается равной исходной в обоих сравнениях: Истина.
Поле date после стандартного чтения имеет тип Строка, не Дата.
Измените секунды исходной даты на 45: после обратного чтения они остаются 45.
Ожидаемый результат
Проверен локальный ISO-контракт и явное преобразование строки JSON в дату.
На что обратить внимание
Даты без указания пояса ПрочитатьДатуJSON интерпретирует в поясе локального компьютера: для внешнего API это должно быть явно согласовано.
Не добавляйте Z к локальной строке без преобразования: это меняет смысл времени.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.
Разобрать внутренний строковый формат в старом коде
Проверяем обратное преобразование простой даты, но явно не рекомендуем этот формат для нового обмена. Это пример чтения совместимого старого кода.
Где и как запускать
Учебная база: создайте серверный общий модуль УчебныеЗадачи (флаг Сервер). Код без директив вставьте в тело процедуры ВыполнитьПример() Экспорт. Вызовите её из серверного обработчика команды учебной обработки. Не запускайте в рабочей базе.
Подготовка
Используйте только строку, полученную тут же из собственного значения. Не загружайте неизвестные системные представления из интернета.
Локальная справка относит эти методы к совместимости с 1С 7.7 и не рекомендует их для других целей.
ИсходнаяДата = Дата(2026, 10, 2, 10, 20, 30);
ВнутренняяСтрока = ЗначениеВСтрокуВнутр(ИсходнаяДата);
Восстановлено = ЗначениеИзСтрокиВнутр(ВнутренняяСтрока);
Сообщить(ТипЗнч(Восстановлено) = Тип("Дата"));
Сообщить(Восстановлено = ИсходнаяДата);
Сообщить(ВнутренняяСтрока);
СтрокаДляJSON = ЗаписатьДатуJSON(ИсходнаяДата, ФорматДатыJSON.ISO, ВариантЗаписиДатыJSON.ЛокальнаяДата);
Сообщить(СтрокаДляJSON);
Сообщить("Внутренний формат не является контрактом внешнего JSON API");Разбор по шагам
ЗначениеВСтрокуВнутр создаёт специальное системное представление; его внешний синтаксис не объявляем стабильным контрактом.
ЗначениеИзСтрокиВнутр восстанавливает свою строку в исходный тип и значение.
Для сравнения отдельно выводим ISO-строку JSON-даты. Она имеет другой формат и явно заданную семантику локального времени.
Как проверить результат
Восстановленный тип Дата, значение равно исходному: два сравнения Истина.
Обе строки выводятся, но не приравниваются друг к другу.
В примере нет ссылок на объекты разных баз и обещания переносимости их внутренних идентификаторов.
Ожидаемый результат
Показано назначение старого API и граница его применения при чтении legacy-кода.
На что обратить внимание
Внутренний формат использует идентификацию данных внутри одной информационной базы; не применяйте его для универсального переноса ссылок.
Новая интеграция должна иметь явный контракт сериализации, а не зависеть от внутреннего представления платформы.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.