Тип QML Locale

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

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

Свойства

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

Методы

• строка currencySymbol(формат)
• строка dateFormat(тип)
• строка dateTimeFormat(тип)
• строка dayName(день, тип)
• строка monthName(месяц, тип)
• строка standaloneDayName(день, тип)
• строка standaloneMonthName(месяц, тип)
• строка timeFormat(тип)

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

Объект 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.

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

См. также 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

Примечание: что эти значения соответствуют API JS Date, что отличается от API Qt C++, где Qt::Sunday = 7.

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 : строка

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

percent : строка

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

pmText : строка

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

positiveSign : строка

Содержит знак плюс для этой локали.

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

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

• Qt.LeftToRight
• Qt.RightToLeft

uiLanguages : Массив<строка>

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

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

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

weekDays : Массив<целое>

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

См. также firstDayOfWeek.

zeroDigit : строка

Возвращает символ нуля для данной локали.

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

строка currencySymbol(формат)

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

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

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

строка dateFormat(тип)

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

См. также Date.

строка dateTimeFormat(тип)

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

См. также Date.

строка dayName(день, тип)

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

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

строка monthName(месяц, тип)

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

Примечание: API QLocale C++ ожидает диапазон (1-12), однако Locale.monthName() ожидает 0-11 в соответствии с объектом JS Date.

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

строка standaloneDayName(день, тип)

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

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

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

строка standaloneMonthName(месяц, тип)

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

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

Примечание: API QLocale C++ ожидает диапазон (1-12), однако Locale.standaloneMonthName() ожидает 0-11 в соответствии с объектом JS Date.

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

строка timeFormat(тип)

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

См. также Date.