Тип QML Locale

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

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

Свойства

• NumberOption : перечисление
• amText : строка
• decimalPoint : строка
• exponential : строка
• firstDayOfWeek : перечисление
• groupSeparator : строка
• measurementSystem : перечисление
• name : строка
• nativeCountryName : строка
• nativeLanguageName : строка
• negativeSign : строка
• percent : строка
• pmText : строка
• positiveSign : строка
• textDirection : перечисление
• uiLanguages : Массив<строка>
• weekDays : Массив<int>
• 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, представляющий локаль с указанным именем, имеющим формат "language[_territory][.codeset][@modifier]" или "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.

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

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

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

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

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

Примечание: эти значения соответствуют JS API даты, что отличается от 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 : 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.