Skip to content

NSLocale ​

NSLocale 表示一个地区:一种语言,加上国家或地区,以及跟着它们走的格式——货币、小数点和千分位、日历、引号、公制还是英制。

用户的设置从三个静态属性读:

iOS 把语言和地区分成两项设置,用户可以设成「语言英文、地区中国」。所以「用什么语言显示界面」和「用什么格式写金额和日期」要分开取:前者看 currentLocale 的语言,后者看它的地区和格式。

用户改了地区设置,application 上派发 localechange 事件。

继承关系:EventTarget → NSObject → NSLocale

构造函数 ​

NSLocale()

按地区标识建一个地区,比如 new NSLocale('de_DE')。

静态属性 ​

属性说明
preferredLanguages 只读用户在系统设置里排好序的语言
currentLocale 只读App 所用的地区,读的那一刻的值
autoupdatingCurrentLocale 只读App 所用的地区,值跟着设置变
systemLocale 只读不属于任何语言和地区的通用地区
availableLocaleIdentifiers 只读系统认得的全部地区标识
ISOLanguageCodes 只读全部语言代码
ISOCountryCodes 只读全部国家和地区代码
ISOCurrencyCodes 只读全部货币代码
commonISOCurrencyCodes 只读常用的货币代码

静态方法 ​

方法说明
localeWithLocaleIdentifier()按地区标识建一个地区,和 new 一样
canonicalLocaleIdentifierFromString()把地区标识改成标准的大小写
canonicalLanguageIdentifierFromString()把地区标识改成标准的语言标识
characterDirectionForLanguage()一种语言的文字在一行里朝哪个方向写
lineDirectionForLanguage()一种语言的行朝哪个方向排

实例属性 ​

还继承 NSObject 的属性。下面的属性全部只读。

语言和地区:

属性说明
localeIdentifier地区标识,形如 'de_DE'
languageCode语言代码,形如 'de'
languageIdentifier语言标识,形如 'de-DE'
regionCode国家或地区代码,形如 'DE',可能是 null
scriptCode文字代码,形如 'Hant',可能是 null
variantCode变体代码,可能是 null

格式:

属性说明
currencyCode货币代码,形如 'EUR',可能是 null
currencySymbol货币符号,形如 '€'
decimalSeparator小数点
groupingSeparator千分位分隔符
usesMetricSystem是否用公制
calendarIdentifier日历,形如 'gregorian'
collationIdentifier排序文字的规则
collatorIdentifier排序文字时用的标识
quotationBeginDelimiter开引号
quotationEndDelimiter闭引号
alternateQuotationBeginDelimiter引号里套引号时的开引号
alternateQuotationEndDelimiter引号里套引号时的闭引号

实例方法 ​

用这个地区的语言说出一个代码的名字:

方法说明
localizedStringForLocaleIdentifier()地区标识的名字:'fr_FR' → 'French (France)'
localizedStringForLanguageCode()语言的名字:'de' → 'German'
localizedStringForCountryCode()国家或地区的名字:'JP' → 'Japan'
localizedStringForScriptCode()文字的名字:'Hant' → 'Traditional Han'
localizedStringForVariantCode()变体的名字
localizedStringForCalendarIdentifier()日历的名字:'gregorian' → 'Gregorian Calendar'
localizedStringForCollationIdentifier()排序规则的名字
localizedStringForCurrencyCode()货币的名字:'EUR' → 'Euro'
localizedStringForCollatorIdentifier()排序标识的名字

事件 ​

NSLocale 自己不派发事件。用户改了地区设置时派发的是 application 上的 localechange。

示例 ​

读用户的语言和地区 ​

js
const locale = NSLocale.currentLocale;
console.log(JSON.stringify(NSLocale.preferredLanguages));
console.log(locale.languageCode, locale.regionCode, locale.currencyCode);
console.log(locale.decimalSeparator, locale.usesMetricSystem);

结果:在 iPhone Air 模拟器(iOS 27.2,系统语言简体中文、地区中国)上运行验收 App(它只支持英文),输出三行:

["zh-Hans-CN"]
en CN CNY
. true

首选语言是中文,currentLocale 的语言却是英文:App 只支持英文,系统就给了英文。

选界面语言 ​

App 自己带了几种语言的文案、要按用户的偏好挑一种时,从 preferredLanguages 里按顺序找第一个自己有的:

js
const supported = ['en', 'zh-Hans', 'ja'];
function pickLanguage() {
  for (const tag of NSLocale.preferredLanguages) {
    const locale = new NSLocale(tag);
    const script = locale.scriptCode;
    const candidates = [script === null ? locale.languageCode : locale.languageCode + '-' + script, locale.languageCode];
    for (const c of candidates) {
      if (supported.includes(c)) return c;
    }
  }
  return supported[0];
}
console.log(pickLanguage());

结果:首选语言是 zh-Hans-CN 时,new NSLocale('zh-Hans-CN') 的 scriptCode 是 'Hans',输出 zh-Hans。未在模拟器验证。

对应的 iOS API ​

ObjCJS
[NSLocale preferredLanguages]NSLocale.preferredLanguages
[NSLocale currentLocale]NSLocale.currentLocale
[[NSLocale alloc] initWithLocaleIdentifier:@"de_DE"]new NSLocale('de_DE')
locale.regionCodelocale.regionCode
locale.countryCodelocale.regionCode
[locale objectForKey:NSLocaleCurrencyCode]locale.currencyCode
[locale displayNameForKey:NSLocaleLanguageCode value:@"de"]locale.localizedStringForLanguageCode('de')
NSLocaleLanguageDirectionRightToLeft'rightToLeft'
NSCurrentLocaleDidChangeNotificationapplication.addEventListener('localechange', …)

参见 ​