Тип QML Locale

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

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

Свойства

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

Методы

• строка currencySymbol(format)
• строка dateFormat(type)
• строка dateTimeFormat(type)
• строка dayName(day, type)
• строка 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.

Типы форматов строк Locale

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

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

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

См. также Дата и Число.

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

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(тип)

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

См. также Дата.

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

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

См. также Дата.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

См. также Дата.