Тип 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.

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

Методы 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 : 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)

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

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

string monthName(month, type)

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

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

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

string standaloneDayName(day, type)

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

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

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

string standaloneMonthName(month, type)

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

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

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

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

string timeFormat(type)

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

См. также Date.