Тип QML Locale

Предоставляет свойства и отформатированные данные, специфичные для локали. Подробнее...

• Список всех членов, включая унаследованные

Свойства

• amText : строка
• decimalPoint : строка
• exponential : строка
• firstDayOfWeek : перечисление
• groupSeparator : строка
• measurementSystem : перечисление
• name : строка
• nativeCountryName : строка
• nativeLanguageName : строка
• negativeSign : строка
• numberOptions : перечисление
• percent : строка
• pmText : строка
• positiveSign : строка
• textDirection : перечисление
• uiLanguages : Массив<строка>
• weekDays : Массив<целое>
• zeroDigit : строка

Методы

• строка currencySymbol(format)
• строка dateFormat(type)
• строка dateTimeFormat(type)
• строка dayName(day, type)
• строка formattedDataSize(int bytes, int precision, DataSizeFormat format)
• строка monthName(month, type)
• строка standaloneDayName(day, type)
• строка standaloneMonthName(month, type)
• строка timeFormat(type)

Подробное описание

Объект Locale может быть создан только с помощью функции Qt.locale(). Он не может быть создан напрямую.

Функция Qt.locale() возвращает JS-объект Locale, представляющий локаль с указанным именем, имеющий формат "язык[_регион][.кодировка][@модификатор]" или "C".

Locale поддерживает концепцию стандартной локали, которая определяется системными настройками локали во время запуска приложения. Если в Qt.locale() не передается параметр, возвращается объект стандартной локали.

Объект Locale предоставляет ряд функций и свойств, предоставляющих данные для указанной локали.

Объект Locale также может быть передан методам Date и Number toLocaleString() и fromLocaleString(), чтобы преобразовывать в/из строк с использованием указанной локали.

Этот пример показывает текущую дату, отформатированную для немецкой локали:

import QtQuick 2.0

Text {
    text: "The date is: " + Date().toLocaleString(Qt.locale("de_DE"))
}

Следующий пример отображает указанное число в правильном формате для стандартной локали:

import QtQuick 2.0

Text {
    text: "The value is: " + Number(23443.34).toLocaleString(Qt.locale())
}

Данные Qt Quick Locale основаны на Common Locale Data Repository v1.8.1.

Типы форматирования строк локали

Методы monthName(), standaloneMonthName(), dayName() и standaloneDayName() могут использовать следующие значения перечисления для указания форматирования строкового представления объекта Date.

• Locale.LongFormat Полное представление названий дней и месяцев; например, возвращает "январь" как название месяца.
• Locale.ShortFormat Короткое представление названий дней и месяцев; например, возвращает "янв" как название месяца.
• Locale.NarrowFormat Специальное представление названий дней и месяцев для использования при ограниченном пространстве; например, возвращает "Я" как название месяца. Обратите внимание, что узкий формат может содержать один и тот же текст для разных месяцев и дней или даже быть пустой строкой, если локали не поддерживает узкие имена, поэтому следует избегать его использования для форматирования даты. Также для системной локали этот формат такой же, как ShortFormat.

Кроме того, функции преобразования double-в-строку и строка-в-double покрываются следующими лицензиями:

См. также Date и Number.

Документация по свойствам

amText : строка

Локализованное имя суффикса "AM" для времени, указанного с использованием правил 12-часовых часов.

decimalPoint : строка

Содержит символ десятичной точки данной локали.

exponential : строка

Содержит экспоненциальный символ данной локали.

firstDayOfWeek : перечисление

Содержит первый день недели в соответствии с текущей локалью.

• Locale.Sunday = 0
• Locale.Monday = 1
• Locale.Tuesday = 2
• Locale.Wednesday = 3
• Locale.Thursday = 4
• Locale.Friday = 5
• Locale.Saturday = 6

groupSeparator : строка

Содержит разделитель групп данной локали.

measurementSystem : перечисление

Это свойство определяет, какие единицы используются для измерения.

• Locale.MetricSystem Это значение указывает на метрические единицы, такие как метры, сантиметры и миллиметры.
• Locale.ImperialUSSystem Это значение указывает на имперские единицы, такие как дюймы и мили, как они используются в США.
• Locale.ImperialUKSystem Это значение указывает на имперские единицы, такие как дюймы и мили, как они используются в Соединенном Королевстве.
• Locale.ImperialSystem Предоставлено для совместимости. То же самое, что и Locale.ImperialUSSystem.

name : строка

Содержит язык и страну данной локали в виде строки "язык_страна", где язык — это двухбуквенный код языка ISO 639 в нижнем регистре, а страна — это двух- или трехбуквенный код страны ISO 3166 в верхнем регистре.

nativeCountryName : строка

Содержит собственное имя страны для локали. Например, "España" для локали Испанский/Испания.

См. также nativeLanguageName.

nativeLanguageName : строка

Содержит собственное имя языка для локали. Например, "Schwiizertüütsch" для швейцарско-немецкой локали.

См. также nativeCountryName.

negativeSign : строка

Содержит символ отрицательного знака данной локали.

numberOptions : перечисление

Содержит набор опций для преобразования чисел в строки и строк в числа.

См. также Number::toLocaleString() и Number::fromLocaleString().

percent : строка

Содержит символ процента данной локали.

pmText : строка

Локализованное имя суффикса "PM" для времени, указанного с использованием правил 12-часовых часов.

positiveSign : строка

Содержит символ положительного знака данной локали.

textDirection : перечисление

Содержит направление текста языка:

• Qt.LeftToRight
• Qt.RightToLeft

uiLanguages : Array<string>

Возвращает упорядоченный список кодов локалей для целей перевода в порядке предпочтения.

Возвращаемое значение представляет имена локалей, в которых пользователь ожидает увидеть перевод пользовательского интерфейса.

Первый элемент в списке имеет наивысший приоритет.

weekDays : Array<int>

Содержит массив дней, которые считаются днями недели в соответствии с текущей локалью, где Воскресенье — 0, а Суббота — 6.

См. также firstDayOfWeek.

zeroDigit : string

Содержит символ нуля для данной локали.

Документация по методам

string currencySymbol(format)

Возвращает символ валюты для указанного формата:

• Locale.CurrencyIsoCode — код валюты ISO-4217.
• Locale.CurrencySymbol — символ валюты.
• Locale.CurrencyDisplayName — удобочитаемое название валюты.

См. также Number::toLocaleCurrencyString().

string dateFormat(type)

Возвращает формат даты, используемый для текущей локали. type задаёт FormatType для возврата.

См. также Date.

string dateTimeFormat(type)

Возвращает формат даты и времени, используемый для текущей локали. type задаёт FormatType для возврата.

См. также Date.

string dayName(day, type)

Возвращает локальное имя дня day (где 0 — Воскресенье, 1 — Понедельник и так далее) в указанном необязательном формате FormatType type.

См. также monthName() и standaloneDayName().

[since 6.2] string formattedDataSize(int bytes, int precision, DataSizeFormat format)

Преобразует размер в байтах bytes в удобочитаемую строку с локализацией, состоящую из числа и единицы измерения.

Аргументы precision и format необязательны.

Для получения более подробной информации, см. QLocale::formattedDataSize().

Этот метод был введён в Qt 6.2.

См. также QLocale::DataSizeFormats.

string monthName(month, type)

Возвращает локальное имя месяца month (0—11) в необязательном формате FormatType, заданном type.

См. также dayName() и standaloneMonthName().

string standaloneDayName(day, type)

Возвращает локальное имя дня day (где 0 — Воскресенье, 1 — Понедельник и так далее), используемое как самостоятельный текст, в формате FormatType, заданном type.

Если информация о локали не определяет самостоятельное имя дня, то возвращаемое значение такое же, как в dayName().

См. также dayName() и standaloneMonthName().

string standaloneMonthName(month, type)

Возвращает локальное имя месяца month (0—11), используемое как самостоятельный текст, в необязательном формате FormatType, заданном type.

См. также monthName() и standaloneDayName().

string timeFormat(type)

Возвращает формат времени, используемый для текущей локали. type задаёт FormatType для возврата.

См. также Date.