Тип 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 также может быть передан методам 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-API Date, что отличается от 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 : 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.