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

Локаль поддерживает понятие локальной по умолчанию, которая определяется настройками локали системы при запуске приложения. Если в 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

Примечание: эти значения соответствуют JS Date API, что отличается от Qt C++ API, где 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(тип)

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

См. также Date.

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

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

См. также Date.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

См. также Date.