地区 QML 类型

提供地区特定属性和格式化数据。更多信息...

导入语句	import QtQml

属性

amText : string
decimalPoint : string
exponential : string
firstDayOfWeek :枚举
groupSeparator : string
measurementSystem :枚举
name : string
nativeLanguageName : string
nativeTerritoryName : string
negativeSign : string
numberOptions :枚举
percent : string
pmText : string
positiveSign : string
textDirection :枚举
uiLanguages : Array<string>
weekDays : Array<int>
zeroDigit : string

方法

string currencySymbol(format)
string dateFormat(type)
string dateTimeFormat(type)
string dayName(day, type)
string formattedDataSize(int bytes, int precision, DataSizeFormat format) (since 6.2)
string monthName(month, type)
string standaloneDayName(day, type)
string standaloneMonthName(month, type)
string timeFormat(type)
string toString(int i) (since 6.5)
string toString(double f, char format, int precision) (since 6.5)
string toString(Date date, string format) (since 6.5)
string toString(Date date, FormatType format) (since 6.5)

详细描述

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`	日和月名称的长的版本；例如，将“January”作为月名称返回。
`Locale.ShortFormat`	日和月名称的短的版本；例如，将“Jan”作为月名称返回。
`Locale.NarrowFormat`	用于空间受限时的特殊版本的日和月名称；例如，将“J”作为月名称返回。请注意，窄格式可能会包含不同月份和天的相同文本，或者甚至可以是空字符串，如果区域设置不支持窄名称，因此应避免使用它进行日期格式化。此外，对于系统区域设置，此格式与ShortFormat相同。

此外，双精度到字符串和字符串到双精度转换函数也受以下许可证覆盖

版权（c）1991年辉达公司。

特此授予使用、复制、修改和分发此软件的任何目的而不收费用的许可权，前提是所有软件的副本或修改版本以及此类软件的相应支持文档的副本都包含此完整通知。

本软件按“现状”提供，不提供任何明确的或暗示的保证。特别是，作者和辉达公司都不对软件的商用性或对其适用特定用途的适宜性做出任何声明或保证。

本产品包括加州大学伯克利分校及其贡献者开发的软件。

另请参阅Date和Number。

属性文档

amText : string

使用12小时制约定指定的“AM”后缀的本地化名称。

decimalPoint : string

包含此区域设置的十进制点字符。

exponential : string

包含此区域设置的指数字符。

firstDayOfWeek : enumeration

包含当前区域设置的每周第一天。

常量	描述
`Locale.Sunday`	0
`Locale.Monday`	1
`Locale.Tuesday`	2
`Locale.Wednesday`	3
`Locale.Thursday`	4
`Locale.Friday`	5
`Locale.Saturday`	6

注意：这些值与JS日期API相匹配，这与Qt C++ API不同，在Qt C++ API中 Qt::Sunday = 7。

groupSeparator : string

持有此区域设置的分组分隔符字符。

measurementSystem : enumeration

该属性定义了用于测量的单元。

常量	描述
`Locale.MetricSystem`	此值表示公制单位，例如米、厘米和毫米。
`Locale.ImperialUSSystem`	此值表示英制单位，如英寸和英里，在美国使用。
`Locale.ImperialUKSystem`	此值表示英制单位，如英寸和英里，在英国使用。
`Locale.ImperialSystem`	为兼容性提供。与Locale.ImperialUSSystem相同。

name : string

持有语言和地区的字符串，格式为"language_territory"，其中语言是小写的两个字母ISO 639语言代码，地区是两个或三个字母的大写ISO 3166地区代码。

nativeLanguageName : string

持有对此区域设置语言的本地名称。例如，瑞士德语区域为"Schwiizertüütsch"。

另请参阅nativeTerritoryName。

nativeTerritoryName : string

持有对此区域设置地区的本地名称。例如，西班牙/西班牙区域为"España"。

另请参阅nativeLanguageName。

negativeSign : string

持有此区域设置的负号字符。

numberOptions : enumeration

持有数字到字符串和字符串到数字转换的选项集。

另请参阅Number::toLocaleString() 和 Number::fromLocaleString().

percent : string

持有此区域设置的百分号字符。

pmText : string

使用12小时制的惯例指定时间的"PM"后缀的本地化名称。

positiveSign : string

持有此区域设置的正号字符。

textDirection : enumeration

持有语言的文本方向

常量	描述
`Qt.LeftToRight`	文本通常从左侧开始。
`Qt.RightToLeft`	文本通常从右侧开始。

uiLanguages : Array<string>

返回一个有序的地理位置名称列表，用于翻译目的，按优先顺序。

返回值表示用户期望在UI翻译中看到的地理位置名称。

列表中的第一个项目是最受欢迎的一个。

weekDays : Array<int>

根据当前区域设置，包含一个数组，表示被视为工作日的日子，其中星期日为0，星期六为6。

另请参阅firstDayOfWeek。

zeroDigit : 字符串

返回当前区域设置的零数字符。

方法说明

字符串 currencySymbol(格式)

返回指定格式的货币符号。

常量	描述
`Locale.CurrencyIsoCode`	货币的 ISO-4217 代码。
`Locale.CurrencySymbol`	货币符号。
`Locale.CurrencyDisplayName`	货币的用户可读名称。

另请参阅Number::toLocaleCurrencyString。

字符串 dateFormat(类型)

返回当前区域设置使用的日期格式。类型指定要返回的 FormatType。

另请参阅日期。

字符串 dateTimeFormat(类型)

返回当前区域设置使用的日期时间格式。类型指定要返回的 FormatType。

另请参阅日期。

字符串 dayName(day, type)

返回可选的 type 指定的，day 的本地化名称（其中 0 代表周日，1 代表周一，依此类推）。

另请参阅monthName() 和 standaloneDayName。

[since 6.2] 字符串 formattedDataSize(整型 bytes, 整型精度, DataSizeFormat 格式)

将 bytes 的大小转换为包含数字和量度单位的可读的本地化字符串。

参数精度和格式是可选的。

有关更多信息，请参阅 QLocale::formattedDataSize。

此方法于 Qt 6.2 中引入。

另请参阅QLocale::DataSizeFormats。

字符串 monthName(month, type)

在指定的可选 type 下返回 month 的本地化名称（0-11）。

注意： QLocale C++ API 期望范围是（1-12），然而 Locale.monthName() 按照 JS Date 对象期望 0-11。

另请参阅dayName() 和 standaloneMonthName。

字符串 standaloneDayName(day, type)

在指定 type 的 FormatType 下返回作为独立文本使用的 day 的本地化名称（其中 0 代表周日，1 代表周一，依此类推）。

如果区域信息未指定独立天数名称，则返回值与在 dayName() 中相同。

另请参阅dayName() 和 standaloneMonthName。

字符串 standaloneMonthName(month, type)

在指定的可选 FormatType 下返回作为独立文本使用的 month 的本地化名称（0-11）。

如果区域信息未指定独立月份名称，则返回值与在 monthName() 中相同。

注意： QLocale C++ API 指望的范围是（1-12），然而 Locale.standaloneMonthName() 按照 JS Date 对象期望 0-11。

另请参阅monthName() 和 standaloneDayName。

字符串 timeFormat(类型)

返回当前区域设置使用的日期时间格式。参数类型指定要返回的格式类型。

另请参阅日期。

[自 6.5 开始] 字符串 toString(int i)

返回 i 的本地化字符串表示形式。

此方法是在 Qt 6.5 中引入的。

另请参阅QLocale::toString(int)。

[自 6.5 开始] 字符串 toString(double f, char format = 'g', int precision = 6)

这是一个重载函数。

返回浮点数 f 的字符串表示形式。

表示形式的格式由可选的 format 和 precision 参数控制。

有关更多信息，请参阅 QLocale::toString(double, char, int)。

此方法是在 Qt 6.5 中引入的。

[自 6.5 开始] 字符串 toString(Date date, 字符串 format)

这是一个重载函数。

在指定的 format 中，返回给定 date 的本地化字符串表示形式。如果 format 是空字符串，则返回空字符串。

此方法是在 Qt 6.5 中引入的。

另请参阅QLocale::toString(QDate, QStringView)。

[自 6.5 开始] 字符串 toString(Date date, FormatType format = LongFormat)

这是一个重载函数。

返回给定 date 在指定 format 中的本地化字符串表示形式。如果 format 被省略，则使用 Locale.LongFormat。

此方法是在 Qt 6.5 中引入的。

另请参阅QLocale::toString(QDate, QLocale::FormatType)。