Перейти к основному содержимому

Локаль

Стд::Локализация::Локаль

Описатель локали (региональных особенностей).

Сравнение

Структурное

Иерархия типа​

Базовые типы: Объект, Представляемое

Литералы​

Поддерживается указание локали в виде литерала, где в качестве значения указывается языковой тег, согласно стандарта BCP 47

Примеры​

знч БританскийАнглийский = Локаль{en-GB}

Конструкторы​

Локаль​

Локаль(ТегЯзыка: Строка)
Создает локаль на основании тега языка. В системе разрешено применение только поддерживаемых локалей. Если в параметре ТегЯзыка передан идентификатор локали, который системой не поддерживается, то будет выдано исключение ИсключениеНедопустимыйАргумент.

Свойства​

КодПисьменности​

ТолькоЧтение

КодПисьменности: Строка

Возвращает код письменности локали

КодРегиона​

ТолькоЧтение

КодРегиона: Строка

Возвращает код региона (страны) локали

КодЯзыка​

ТолькоЧтение

КодЯзыка: Строка

Возвращает код языка локали

Методы​

ВСтроку​

ВСтроку(): Строка
Возвращает тег языка локали

Переопределение
Объект::ВСтроку

ИзСтроки​

Статический

ИзСтроки(ТегЯзыка: Строка): Локаль
Возвращает локаль на основании тега языка. В системе разрешено применение только поддерживаемых локалей. Если в параметре ТегЯзыка передан идентификатор локали, который системой не поддерживается, то будет предпринята попытка вернуть локаль наиболее близко подходящую к переданной.

Если такой подбор не удастся (например, передано совершенно некорректное или неизвестное значение локали), то возвращается локаль по умолчанию.

ИзвестныеЛокали​

Статический

ИзвестныеЛокали(): ЧитаемоеМножество<Локаль>
Список локалей, поддерживаемых в системе.

Представление​

Представление(): Строка
Представление локали на языке активной локали. Например, в локали ru-RU возвращает русский (Россия), а в локали es-ES возвращает ruso (Rusia)

Переопределение
Представляемое::Представление

Перегрузка
Представление(Локаль: Локаль): Строка

Представление​

Представление(Локаль: Локаль): Строка
Представление локали на языке заданной локали.

Параметр Локаль определяет локаль, в которой надо показать представление объекта локали. Например, часто для выбора языка этот язык показывают на нем самом, чтобы пользователь смог легко прочитать его на родном языке.

Перегрузка
Представление(): Строка

Примеры​

Сформируем список выбора локали и покажем его пользователю. Представление локали показываем на языке самой локали, чтобы пользователь смог легко прочитать его на родном языке.

метод СписокВыбора(): Массив<Массив<Локаль?>>
    знч ПоддерживаемыеЯзыки = {"en", "ru", "fr"}

    знч Отображение = Локаль.ИзвестныеЛокали().Фильтровать(Л -> ПоддерживаемыеЯзыки.Содержит(Л.КодЯзыка))
        .Преобразовать(Л -> новый Массив<Локаль?>())
    
    
    возврат Отображение
;

ТекущаяЛокальОтображения​

Статический

ТекущаяЛокальОтображения(): Локаль
Статический метод. Возвращает текущую локаль отображения, в которой сейчас работает код.

ТекущаяЛокальФорматирования​

Статический

ТекущаяЛокальФорматирования(): Локаль
Статический метод. Возвращает текущую локаль форматирования, в которой сейчас работает код.

Примеры​

если Локаль.ТекущаяЛокальОтображения().КодРегиона == "ES"
    // Попробуем предложить акцию для Испании
    знч Уведомление = новый Уведомление(Заголовок = "Акция!", Текст = "Только сейчас скидки в наших магазинах в Испании!")
    Консоль.Записать(Уведомление)
;

Список унаследованных методов​

Объект​

ВСтроку (Переопределение)

ПолучитьТип

Представляемое​

Представление (Переопределение)

Последнее обновление