Тип: ВариантЗаписиДатыJSON. Вариант записи даты JSON.
Полное описание, параметры и ограничения
НастройкиСериализацииJSON.ВариантЗаписиДаты (JSONSerializerSettings.DateWritingVariant)
НастройкиСериализацииJSON (JSONSerializerSettings)
ВариантЗаписиДаты (DateWritingVariant)
Доступен, начиная с версии 8.3.6.
Использование:
Чтение и запись.
Описание:
Тип: ВариантЗаписиДатыJSON.
Вариант записи даты JSON.
Доступность:
Тонкий клиент, мобильный клиент, сервер, толстый клиент, внешнее соединение, мобильное приложение (клиент), мобильное приложение (сервер), мобильный автономный сервер.
Использование в версии:
Доступен, начиная с версии 8.3.6.
Методическая информация
Практические примеры
Согласовать локальную календарную дату в формате 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 к локальной строке без преобразования: это меняет смысл времени.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.