Get the list of available time zones. |
|
Gets the list of countries available for localization |
|
Gets the current country; based on the current locale settings in the Servoy Client Locale preferences. |
|
Gets the current language; based on the current locale settings in the Servoy Client Locale preferences. |
|
Gets the current time zone of the client; based on the current locale settings in the Servoy Client Locale preferences. |
|
Gets the current default date format; based on the current locale settings in the Servoy Client Locale preferences. |
|
Gets the current default number format; based on the current locale settings in the Servoy Client Locale preferences. |
|
Gets the real message (for the clients locale) for a specified message key. |
|
Gets the real message (for the clients locale) for a specified message key. |
|
Returns a dataset with rows that contains a language key (en) and the displayname (English) column. |
|
Returns a dataset with rows that contains 3 columns: 'key' (i18n key), 'reference' (reference text for that key) and 'locale ([CURRENT_LOCALE])' (where [CURRENT_LOCALE] is the current language) - with the system messages of servoy. |
|
Returns the offset (in milliseconds) of this time zone from UTC for the current date or at the specified date. |
|
Returns the offset (in milliseconds) of this time zone from UTC for the current date or at the specified date. |
|
Returns an array of known timezones. |
|
Sets the value of i18n key for client scope,if value null the setting is removed. |
|
Set/Overwrite the locale for this client. |
|
Sets the current time zone of the client. |
|
|
getAvailableTimeZoneIDs() |
|
Get the list of available time zones. |
|
|
Supported Clients SmartClient,WebClient,NGClient |
|
|
Sample //Get the list of available time zones
var timezones = i18n.getAvailableTimeZoneIDs(); |
|
|
|
|
Gets the list of countries available for localization |
|
|
Supported Clients SmartClient,WebClient,NGClient |
|
|
|
Gets the current country; based on the current locale settings in the Servoy Client Locale preferences.
NOTE: For more information on i18n, see the chapter on Internationalization in the Servoy Developer User's Guide, and the chapter on Internationalization-I18N in the Programming Guide. |
|
|
Supported Clients SmartClient,WebClient,NGClient |
|
|
Sample var currCountry = i18n.getCurrentCountry(); |
|
|
|
|
Gets the current language; based on the current locale settings in the Servoy Client Locale preferences.
NOTE: For more information on i18n, see the chapter on Internationalization in the Servoy Developer User's Guide, and the chapter on Internationalization-I18N in the Programming Guide. |
|
|
Supported Clients SmartClient,WebClient,NGClient,MobileClient |
|
|
Sample var currLang = i18n.getCurrentLanguage(); |
|
|
|
|
Gets the current time zone of the client; based on the current locale settings in the Servoy Client Locale preferences. For Servoy Web Clients the time zone is given by the browser (if it is possible to obtain it). |
|
|
Supported Clients SmartClient,WebClient,NGClient |
|
|
Sample var currTimeZone = i18n.getCurrentTimeZone(); |
|
|
|
|
Gets the current default date format; based on the current locale settings in the Servoy Client Locale preferences. |
|
|
Supported Clients SmartClient,WebClient,NGClient |
|
|
Sample var defaultDateFormat = i18n.getDefaultDateFormat(); |
|
|
|
|
Gets the current default number format; based on the current locale settings in the Servoy Client Locale preferences. |
|
|
Supported Clients SmartClient,WebClient,NGClient |
|
|
Sample var defaultNumberFormat = i18n.getDefaultNumberFormat(); |
|
|
|
|
Gets the real message (for the clients locale) for a specified message key. |
|
|
Supported Clients SmartClient,WebClient,NGClient,MobileClient |
|
|
Sample // returns 'Welcome my_name in my solution'
// if the key 'mykey.username.text' is 'Welcome {0} in my solution'
i18n.getI18NMessage('mykey.username.text',new Array('my_name')) |
|
|
|
|
getI18NMessage(i18nKey, dynamicValues) |
|
Gets the real message (for the clients locale) for a specified message key.
You can use parameter substitution by using {n}, where n is a index number of the value thats in the arguments array. |
|
|
Parameters Arguments array when using parameter substitution. |
|
|
|
|
Supported Clients SmartClient,WebClient,NGClient,MobileClient |
|
|
Sample // returns 'Welcome my_name in my solution'
// if the key 'mykey.username.text' is 'Welcome {0} in my solution'
i18n.getI18NMessage('mykey.username.text',new Array('my_name')) |
|
|
|
|
Returns a dataset with rows that contains a language key (en) and the displayname (English) column.
See http://www.ics.uci.edu/pub/ietf/http/related/iso639.txt for a list that could be returned. |
|
|
Supported Clients SmartClient,WebClient,NGClient |
|
|
Sample var set = i18n.getLanguages();
for(var i=1;i<=set.getMaxRowIndex();i++)
{
application.output(set.getValue(i, 1) + " " + set.getValue(i, 2));
} |
|
|
|
|
Returns a dataset with rows that contains 3 columns: 'key' (i18n key), 'reference' (reference text for that key) and 'locale ([CURRENT_LOCALE])' (where [CURRENT_LOCALE] is the current language) - with the system messages of servoy.
This means all servoy messages, with all available translations. |
|
|
Supported Clients SmartClient,WebClient,NGClient |
|
|
Sample var set = i18n.getSystemMessages();
for(var i=1;i<=set.getMaxRowIndex();i++)
{
application.output(set.getValue(i, 1) + " " + set.getValue(i, 2)+ " " + set.getValue(i, 3));
} |
|
|
|
|
getTimeZoneOffset(timeZoneId) |
|
Returns the offset (in milliseconds) of this time zone from UTC for the current date or at the specified date. |
|
|
Parameters The time zone to get the offset for. |
|
|
|
|
Supported Clients SmartClient,WebClient,NGClient |
|
|
Sample var timeZoneOffset = i18n.getTimeZoneOffset('America/Los_Angeles'); |
|
|
|
|
getTimeZoneOffset(timeZoneId, date) |
|
Returns the offset (in milliseconds) of this time zone from UTC for the current date or at the specified date. |
|
|
Parameters The time zone to get the offset for. |
|
The date in the time zone (default current date). Needed in case daylight saving time/GMT offset changes are used in the time zone. |
|
|
|
|
Supported Clients SmartClient,WebClient,NGClient |
|
|
Sample var timeZoneOffset = i18n.getTimeZoneOffset('America/Los_Angeles'); |
|
|
|
|
Returns an array of known timezones. |
|
|
Supported Clients SmartClient,WebClient,NGClient |
|
|
Sample var timeZones = i18n.getTimeZones(); |
|
|
|
|
setI18NMessage(i18nKey, value) |
|
Sets the value of i18n key for client scope,if value null the setting is removed.
All forms not yet loaded will change (execute this in solution startup or first form) |
|
|
Parameters They value for the message key. |
|
|
|
|
Supported Clients SmartClient,WebClient,NGClient,MobileClient |
|
|
Sample //sets the value of i18n key for client scope; if value null the setting is removed
//Warning: already created form elements with i18n text lookup will not change,
//so call this method in the solution startup method or in methods from first form
//this method saves message for current locale, so if locale is changed with setLocale, all messages set from scripting will be lost
i18n.setI18NMessage('mykey.username.text','my_name') |
|
|
|
|
setLocale(language, country) |
|
Set/Overwrite the locale for this client.
All forms not yet loaded will change (execute this in solution startup or first form).
The language must be a lowercase 2 letter code defined by ISO-639.
see ISO 639-1 codes at http://en.wikipedia.org/wiki/List_of_ISO_639-1_code
The country must be an upper case 2 letter code defined by ISO-3166
see ISO-3166-1 codes at http://en.wikipedia.org/wiki/ISO_3166-1_alpha-2
NOTE: For more information on i18n, see the chapter on Internationalization in the Servoy Developer User's Guide, and the chapter on Internationalization-I18N in the Programming Guide. |
|
|
Parameters The lowercase 2 letter code |
|
The upper case 2 letter code. |
|
|
|
|
Supported Clients SmartClient,WebClient,NGClient,MobileClient |
|
|
Sample //Warning: already created form elements with i18n text lookup will not change,
//so call this method in the solution startup method or in methods from first form
i18n.setLocale('en','US'); |
|
|
|
|
Sets the current time zone of the client.
The parameter should be a string having the format which can be retrieved via i18n.getAvailableTimeZones or
can be seen in the SmartClient Edit -> Preferences -> Locale at the "Default Timezone" combobox.
For instance the time zone for Netherlands is set using the ID "Europe/Amsterdam". |
|
|
Supported Clients SmartClient,WebClient,NGClient |
|
|
Sample // This will set the default time zone to Central European Time
i18n.setTimeZone("Europe/Amsterdam"); |
|
|
|
|
|
|