Получает массив строк допустимых идентификаторов часовых поясов.
Синтаксис
ПолучитьДопустимыеЧасовыеПояса()Полное описание, параметры и ограничения
Глобальный контекст.ПолучитьДопустимыеЧасовыеПояса (Global context.GetAvailableTimeZones)
Глобальный контекст (Global context)
ПолучитьДопустимыеЧасовыеПояса (GetAvailableTimeZones)
Доступен, начиная с версии 8.2.
Синтаксис:
ПолучитьДопустимыеЧасовыеПояса()
Возвращаемое значение:
Тип: Массив.
Массив содержит строки идентификаторов.
Список допустимых часовых поясов может быть получен методом ПолучитьДопустимыеЧасовыеПояса.
Кроме того, возможно задание часовых поясов смещением от универсального времени (часовые пояса GMT) в формате:
GMT{+/-}h[h][:mm]
где hh=0:23, mm=0:59.
Описание:
Получает массив строк допустимых идентификаторов часовых поясов.
Доступность:
Сервер, толстый клиент, внешнее соединение, мобильное приложение (сервер), мобильный автономный сервер.
См. также:
Глобальный контекст, метод ПредставлениеЧасовогоПояса
Глобальный контекст, метод ПолучитьДопустимыеСтраны
Использование в версии:
Доступен, начиная с версии 8.2.
Методическая информация
Практические примеры
Подготовить список часовых поясов для настройки обмена
В учебной интеграции нужен идентификатор пояса, а не только подпись. Формируем список и показываем первые три записи без предположений об их порядке.
Где и как запускать
Полный серверный общий модуль учебной копии. Только чтение настроек и вычисления в памяти.
Подготовка
Работайте в отдельной учебной копии базы. Создайте серверный общий модуль УчебныеЗадачи, вставьте полный модуль урока и вызовите ВыполнитьПример() из серверного обработчика учебной команды.
Код выполняется на сервере: часть функций локализации и часовых поясов недоступна непосредственно в тонком клиенте. Реквизиты пользователя, региональные настройки и часовые пояса код не меняет.
Для двух уроков о метаданных используйте копию КА2 Progress: в исходном Languages/Русский.xml действительно есть язык Русский с КодЯзыка = ru. Остальные уроки не требуют объектов конкретной конфигурации.
Процедура ВыполнитьПример() Экспорт
Пояса = ПолучитьДопустимыеЧасовыеПояса();
Варианты = Новый СписокЗначений;
Для Каждого Идентификатор Из Пояса Цикл
Варианты.Добавить(Идентификатор, ПредставлениеЧасовогоПояса(Идентификатор));
КонецЦикла;
Сообщить(Варианты.Количество() = Пояса.Количество());
Показано = 0;
Для Каждого Вариант Из Варианты Цикл
Если Показано = 3 Тогда
Прервать;
КонецЕсли;
Сообщить(Строка(Вариант.Значение) + " — " + Вариант.Представление);
Показано = Показано + 1;
КонецЦикла;
Сообщить("Всего поясов: " + Строка(Варианты.Количество()));
Сообщить("Учебный фиксированный пояс: " + ПредставлениеЧасовогоПояса("GMT+3:30"));
КонецПроцедурыРазбор по шагам
ПолучитьДопустимыеЧасовыеПояса возвращает массив строк. Строка-идентификатор становится значением выбора; локализованное наименование — его подписью.
Первые три элемента нужны только для осмотра. Первый пояс не объявляется текущим, ближайшим или правильным для клиента.
Кроме каталога платформа допускает формат GMT{+/-}h[h][:mm]. GMT+3:30 — постоянное учебное смещение; ему не приписываем законодательные правила конкретной страны.
Пример только готовит список. Он не вызывает установку пояса сеанса, информационной базы или ОС.
Как проверить результат
Равенство количеств — Истина; показано не более трёх реальных записей и представление фиксированного пояса.
Если перечень изменится между версиями платформы, код продолжит обходить фактически полученные значения.
Ожидаемый результат
Список можно использовать как исходные данные учебного поля выбора пояса обмена.
На что обратить внимание
Не сохраняйте локализованное представление вместо идентификатора.
Фиксированный GMT-пояс не заменяет именованный региональный пояс с историческими изменениями.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.