Тип 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 также может быть передан методам 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.

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

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

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

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

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

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

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

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.