Тип QML Locale

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

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

Свойства

• amText : строка
• decimalPoint : строка
• exponential : строка
• firstDayOfWeek : перечисление
• groupSeparator : строка
• measurementSystem : перечисление
• name : строка
• nativeCountryName : строка
• nativeLanguageName : строка
• negativeSign : строка
• numberOptions : перечисление
• 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 также может быть передан методам toLocaleString() и fromLocaleString() в Date и Number, чтобы преобразовывать в строки и из строк с использованием указанной локали.

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

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

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

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().

string monthName(month, type)

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

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

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

string standaloneDayName(day, type)

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

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

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

string standaloneMonthName(month, type)

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

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

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

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

string timeFormat(type)

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

См. также Date.