aardio 文档

sys.locale 库模块帮助文档

sys.locale 成员列表

系统区域与语言相关函数，
注意此名字空间下的函数在非XP系统下可用区域名代替 LCID 参数，
相关标准库: win.rt.bcp47,string.conv

sys.locale.getAbbrevName

转换数值格式 LCID 为3字母格式字符串,例如 chs,
3字母转换为LCID 请使用 abbrevNames 表

sys.locale.getAbbrevName(lcid,lowerCase)

转换数值格式 LCID 为3字母格式字符串,例如 chs,
参数@1指定LCID，省略则使用默认值 _LOCALE_SYSTEM_DEFAULT,
可选用 @lowerCase 指定返回字符串是否小写

sys.locale.getCodePage()

返回默认 ANSI 代码页，例如中文为 936

sys.locale.getCountryName

转换数值格式 LCID 为 ISO 3166 国家代码,例如 "CN",
返回值通常为2个字母，但也有极少数的数值，例如"029"

sys.locale.getCountryName(lcid,lowerCase)

转换数值格式 LCID 为 ISO 3166 国家代码,例如 "CN",
参数@1指定LCID，省略则使用默认值 _LOCALE_SYSTEM_DEFAULT
可选用 @lowerCase 指定返回字符串是否转换为小写

sys.locale.getId()

返回表示区域ID（LCID）的数值，
参数@1指定区域名，此函数在 XP 系统返回 null
关于区域名请参考文档： https://docs.microsoft.com/en-us/windows/win32/intl/locale-names

sys.locale.getLangName

转换数值格式 LCID 为 ISO 639 格式语言代码,例如 "zh",
返回值通常为2个字母，但也有极少数3字母，例如"haw"

sys.locale.getLangName(lcid)

转换数值格式 LCID 为 ISO 639 格式语言代码,例如 "zh"

sys.locale.getName

转换数值格式 LCID 为 ISO 639 格式语言与国家代码,例如 "zh-CN"

sys.locale.getName(lcid,concatenation,lowerCase)

转换数值格式 LCID 为 ISO 639 格式字符串,例如 "zh-CN",
参数@1指定LCID，省略则使用默认值 _LOCALE_SYSTEM_DEFAULT,
@concatenation 参数指定分隔符,默认为 "-",
可选用 @lowerCase 指定返回字符串是否转换为小写

sys.locale.getNativeCountryName()

返回国家或区域的本地名称，例如"中国"
参数 @1 可指定 LCID，非 XP 系统可指定区域名称,
关于区域名请参考 getId 函数说明

sys.locale.getNumber(locale,lcType,low,len)

返回指定区域信息，成功返回数值。
参数@locale 指定LCID，省略则使用默认值 _LOCALE_SYSTEM_DEFAULT,
非 XP 系统 @locale 参数可指定字符串，请参考此函数源码与相关 API 文档。
@lcType 参数用法请参考此函数源码与相关 API 文档。
可选用 @lowerCase 指定返回字符串是否小写,
可选用 @len 指定返回字符串最大字符数

sys.locale.getString(locale,lcType,low,len)

返回指定区域信息，成功返回字符串。
参数@locale 指定LCID，省略则使用默认值 _LOCALE_SYSTEM_DEFAULT,
非 XP 系统 @locale 参数可指定字符串，请参考此函数源码与相关 API 文档。
@lcType 参数用法请参考此函数源码与相关 API 文档。
可选用 @lowerCase 指定返回字符串是否小写,
可选用 @len 指定返回字符串最大字符数

sys.locale.getUserDefault()

获取默认区域名，
返回值使用 ISO 639 格式 语言与国家代码。
与 ::Kernel32.GetUserDefaultLangID 函数返回的区域 ID 一致

sys.locale.setUserDefault

设置用户默认区域

sys.locale.setUserDefault(locale,proc)

设置默认字符串参数 @locale 指定的区域名为用户默认区域，
参数支持 RFC 4646 格式。

如果参数 @proc 指定回调函数，则在修改用户默认区域后执行该函数，
在该函数执行完成以后，恢复区域设置。

成功返回 true，此设置会更改 ::Kernel32.GetUserDefaultLangID 函数的返回值

自动完成常量

_LOCALE_SYSTEM_DEFAULT=0x800
_LOCALE_USER_DEFAULT=0x400

Markdown 格式