Interface LocalizationSystem

Helps convert data types to localized string representations. Accessible through global.localizationSystem.

Note that formatted or localized strings may appear differently to users depending on their region. The example results given here are representative of a user in the United States, but may appear differently for users in other regions.

Example

// get today date and time
var currentDate = new Date();
print("Today is: " + global.localizationSystem.getDayOfWeek(currentDate));
print("The current time is: " + global.localizationSystem.getTimeFormatted(currentDate));

// get tomorrow's date
var tomorrow = new Date();
tomorrow.setDate(currentDate.getDate()+1);
print("Tomorrow's date is: " + global.localizationSystem.getDateFormatted(tomorrow));

// show image based on locale
/*
@typedef LanguageTexturePair
@property {string} language 
@property {Asset.Texture} texture 
*/
//@input Asset.Texture defaultTex

//@input Component.Image image
//@input LanguageTexturePair[] pairs

var lang = global.localizationSystem.getLanguage();
var lMap = {}

for (var i = 0; i < script.pairs.length; i++) {
    lMap[script.pairs[i].language] = script.pairs[i].texture;
}
if (lMap[lang] != undefined) {
    script.image.mainMaterial.mainPass.baseTex = lMap[lang];
} else {
    script.image.mainMaterial.mainPass.baseTex = script.defaultTex;
}
interface LocalizationSystem {
    language: string;
    getDateAndTimeFormatted(date: Date): string;
    getDateFormatted(date: Date): string;
    getDateShortFormatted(date: Date): string;
    getDayOfWeek(date: Date): string;
    getFormattedDistanceFromMeters(meters: number): string;
    getFormattedNumber(number: number): string;
    getFormattedSeconds(seconds: number): string;
    getFormattedTemperatureFromCelsius(temperature: number): string;
    getFormattedTemperatureFromFahrenheit(temperature: number): string;
    getLanguage(): string;
    getMonth(date: Date): string;
    getTimeFormatted(date: Date): string;
    getTypeName(): string;
    isOfType(type: string): boolean;
    isSame(other: ScriptObject): boolean;
    localize(key: string): string;
}

Hierarchy (view full)

Properties

language

Methods

getDateAndTimeFormatted getDateFormatted getDateShortFormatted getDayOfWeek getFormattedDistanceFromMeters getFormattedNumber getFormattedSeconds getFormattedTemperatureFromCelsius getFormattedTemperatureFromFahrenheit getLanguage getMonth getTimeFormatted getTypeName isOfType isSame localize

Properties

Exposes User Datalanguage

language: string

Use this property to set the language. Intended for debugging.

Methods

getDateAndTimeFormatted

  • getDateAndTimeFormatted(date): string

  • Returns a localized string for the date and time of the passed in Date object.

    Example: "Jan 1, 2019 at 12:34 AM"

    Parameters

    • date: Date

    Returns string

getDateFormatted

  • getDateFormatted(date): string

  • Returns a localized string for the date of the passed in Date object.

    Example: "Jan 1, 2019"

    Parameters

    • date: Date

    Returns string

getDateShortFormatted

  • getDateShortFormatted(date): string

  • Returns a short, localized string for the date of the passed in Date object.

    Example: "1/1/19"

    Parameters

    • date: Date

    Returns string

getDayOfWeek

  • getDayOfWeek(date): string

  • Returns a localized string for the day of the week of the passed in Date object.

    Example: "Tuesday"

    Parameters

    • date: Date

    Returns string

getFormattedDistanceFromMeters

  • getFormattedDistanceFromMeters(meters): string

  • Returns a localized, formatted string representation of the distance in meters passed in.

    Example: "39.4 in" (from 1 passed in)

    Parameters

    • meters: number

    Returns string

getFormattedNumber

  • getFormattedNumber(number): string

  • Returns a localized, formatted string representation of the number passed in.

    Example: "1,234" (from 1234 passed in)

    Parameters

    • number: number

    Returns string

getFormattedSeconds

  • getFormattedSeconds(seconds): string

  • Returns a localized, formatted string representing the number of seconds passed in.

    Example: "2:06" (from 126 passed in)

    Parameters

    • seconds: number

    Returns string

getFormattedTemperatureFromCelsius

  • getFormattedTemperatureFromCelsius(temperature): string

  • Returns a localized, formatted string representation of the celsius temperature passed in.

    Example: "32F" (from 0 passed in)

    Parameters

    • temperature: number

    Returns string

getFormattedTemperatureFromFahrenheit

  • getFormattedTemperatureFromFahrenheit(temperature): string

  • Returns a localized, formatted string representation of the fahrenheit temperature passed in.

    Example: "32F" (from 32 passed in)

    Parameters

    • temperature: number

    Returns string

getLanguage

  • getLanguage(): string
  • Exposes User Data

    Returns the language code of the language being used on the device.

    Example: "en" (for English)

    Returns string

getMonth

  • getMonth(date): string

  • Returns a localized string for the month of the passed in Date object.

    Example: "January"

    Parameters

    • date: Date

    Returns string

getTimeFormatted

  • getTimeFormatted(date): string

  • Returns a localized string for the time of the passed in Date object.

    Example: "12:34 AM"

    Parameters

    • date: Date

    Returns string

getTypeName

isOfType

  • isOfType(type): boolean

  • Returns true if the object matches or derives from the passed in type.

    Parameters

    • type: string

    Returns boolean

isSame

  • isSame(other): boolean

  • Returns true if this object is the same as other. Useful for checking if two references point to the same thing.

    Parameters

    Returns boolean

localize

  • localize(key): string
  • Exposes User Data

    The method takes a localization key and returns the localized string according to device language. Useful for localizing strings before formatting them and assigning them to Text.

    Parameters

    • key: string

    Returns string

Settings

Member Visibility

On This Page

Properties
Methods