LocaleModule

The LocaleModule class encapsulates access to the locale identifier of the device.

Example

//==============================================================================
// The following example demonstrates how to detect the device language and
// log a greeting in that language.
//==============================================================================
// Load in the required modules
const Diagnostics = require('Diagnostics');
const Locale = require('Locale');
// Store the unedited locale string (made up of the language_territory)
const languageAndTerritory = Locale.fromDevice;
// Log the locale string to the Console
Diagnostics.log('My location and territory are ' + languageAndTerritory);
// Create an array by splitting the locale string, this array will have two
// values, the language [0] and the territory [1]
const localeAsArray = languageAndTerritory.split('_');
// Store the first element in the array (the language)
const language = localeAsArray[0];
// Use a switch statement to say hello in the Console in the correct language
switch (language) {
// English
case 'en':
Diagnostics.log('Hello');
break;
// Spanish
case 'es':
Diagnostics.log('Hola');
break;
// French
case 'fr':
Diagnostics.log('Bonjour');
break;
// Other
default:
Diagnostics.log('Device language is neither English, Spanish nor French');
break;
}

Properties

Property
Description
fromDevice
(get) fromDevice: string (set) (Not Available)
Provides the ISO 639-1 language + ISO 3166-1 region compliant locale identifier, e.g. en_US or zh_HK.
language
(get) language: StringSignal (set) (Not Available)
Provides the ISO 639-1 compliant language identifier, e.g. en or zh.
locale
(get) locale: StringSignal (set) (Not Available)
Provides the ISO 639-1 language + ISO 3166-1 region compliant locale identifier, e.g. en_US or zh_HK.
region
(get) region: StringSignal (set) (Not Available)
Provides the ISO 3166-1 region identifier, e.g. US, or HK.

Methods

This module exposes no methods.

Classes

This module exposes no classes.