Skip to main content

Globalization

EOL Notice

Globalization will reach its end-of-life on July 1, 2024, and will no longer receive updates or support. Please see Support Policy for additional information.

The Globalization plugin provides access to user information including locale, language, and time zone.

Installation

If you have not already setup Ionic Enterprise in your app, follow the one-time setup steps.

Next, install the plugin:

npm install @ionic-enterprise/globalization
npx cap sync

Index

Classes

Interfaces


Classes

Globalization

usage:

import { Globalization } from '@ionic-enterprise/globalization/ngx';

constructor(private globalization: Globalization) { }

...

this.globalization.getPreferredLanguage()
.then(res => console.log(res))
.catch(e => console.log(e));

interfaces: GlobalizationOptions

dateToString

dateToString(date: Date, options: GlobalizationOptions): Promise<object>

Converts date to string

Parameters:

NameTypeDescription
dateDateDate you wish to convert
optionsGlobalizationOptionsOptions for the converted date. Length, selector.

Returns: Promise<object>

} Returns a promise when the date has been converted.


getCurrencyPattern

getCurrencyPattern(currencyCode: string): Promise<object>

Returns a pattern string to format and parse currency values according to the client's user preferences and ISO 4217 currency code.

Parameters:

NameTypeDescription
currencyCodestringCurrency Code.A

Returns: Promise<object>

}


getDateNames

getDateNames(options: object): Promise<object>

Returns an array of the names of the months or days of the week, depending on the client's user preferences and calendar.

Parameters:

options: object

Object with type (narrow or wide) and item (month or days).

NameType
itemstring
typestring

Returns: Promise<object>

} Returns a promise.


getDatePattern

getDatePattern(options: GlobalizationOptions): Promise<object>

Returns a pattern string to format and parse dates according to the client's user preferences.

Parameters:

NameTypeDescription
optionsGlobalizationOptionsObject with the format length and selector

Returns: Promise<object>

} Returns a promise.


getFirstDayOfWeek

getFirstDayOfWeek(): Promise<object>

Returns the first day of the week according to the client's user preferences and calendar.

Returns: Promise<object>

} returns a promise with the value


getLocaleName

getLocaleName(): Promise<object>

Returns the BCP 47 compliant locale identifier string to the successCallback with a properties object as a parameter.

Returns: Promise<object>

}


getNumberPattern

getNumberPattern(options: object): Promise<object>

Returns a pattern string to format and parse numbers according to the client's user preferences.

Parameters:

options: object

Can be decimal, percent, or currency.

NameType
typestring

Returns: Promise<object>

}


getPreferredLanguage

getPreferredLanguage(): Promise<object>

Returns the BCP-47 compliant language identifier tag to the successCallback with a properties object as a parameter. That object should have a value property with a String value.

Returns: Promise<object>

}


isDayLightSavingsTime

isDayLightSavingsTime(date: Date): Promise<object>

Indicates whether daylight savings time is in effect for a given date using the client's time zone and calendar.

Parameters:

NameTypeDescription
dateDateDate to process

Returns: Promise<object>

} reutrns a promise with the value


numberToString

numberToString(numberToConvert: number, options: object): Promise<object>

Returns a number formatted as a string according to the client's user preferences.

Parameters:

numberToConvert: number

The number to convert

options: object

Object with property type that can be set to: decimal, percent, or currency.

NameType
typestring

Returns: Promise<object>


stringToDate

stringToDate(dateString: string, options: GlobalizationOptions): Promise<object>

Parses a date formatted as a string, according to the client's user preferences and calendar using the time zone of the client, and returns the corresponding date object.

Parameters:

NameTypeDescription
dateStringstringDate as a string to be converted
optionsGlobalizationOptionsOptions for the converted date. Length, selector.

Returns: Promise<object>

} Returns a promise when the date has been converted.


stringToNumber

stringToNumber(stringToConvert: string, options: object): Promise<object>

Parameters:

stringToConvert: string

String you want to conver to a number

options: object

The type of number you want to return. Can be decimal, percent, or currency.

NameType
typestring

Returns: Promise<object>

} Returns a promise with the value.



Interfaces

GlobalizationOptions

GlobalizationOptions:

formatLength

● formatLength: string


selector

● selector: string