Application Configuration

NOTE

  • The APIs of this module are no longer maintained since API version 7. It is recommended that you use @ohos.i18n and @ohos.intl instead.

  • The initial APIs of this module are supported since API version 3. Newly added APIs will be marked with a superscript to indicate their earliest API version.

Modules to Import

import configuration from '@system.configuration';

configuration.getLocale

static getLocale(): LocaleResponse

Obtains the current locale of the application, which is the same as the system locale.

System capability: SystemCapability.ArkUI.ArkUI.Lite

Return values

Type Description
LocaleResponse Information about the current locale.

Example

export default {    
  getLocale() {        
    const localeInfo = configuration.getLocale();        
    console.info(localeInfo.language);    
  }
}

LocaleResponse

Defines attributes of the current locale.

System capability: SystemCapability.ArkUI.ArkUI.Lite

Name Type Readable Writable Description
language string Yes No Language, for example, zh.
countryOrRegion string Yes No Country or region, for example, CN or US.
dir string Yes No Text layout direction. The value can be:
- ltr: from left to right
- rtl: from right to left
unicodeSetting5+ string Yes No Unicode language key set determined by the locale. If current locale does not have a specific key set, an empty set is returned.
For example, {"nu":"arab"} indicates that current locale uses Arabic numerals.