This function is used to modify the (language/country) pair used by the browser. The country information is optional.
Changing the (language/country) pair has two effects.
Firstly, the different separation characters (decimal, date, time, grouping separators) are reset to take into account the standard characters relating to the language and country. Likewise, the formatting of DATE and TIMESTAMP variables can be modified by updating the (language/country) pair.
Note: these characters are reset even if they have been set using the VaToolBxAwsSetDecimalSeparatorChar, VaToolBxAwsSetDateSeparatorChar, VaToolBxAwsSetTimeSeparatorChar, VaToolBxAwsSetGroupingSeparatorChar functions.
Secondly, if the application is generated in multilingual mode, then the text constants translated into the chosen language will be used.
Note: We do not recommend using this function in an AJAX event processing block because it leads to the page being only partially refreshed.
Context
Adelia Web client (except web services)
Parameters
ALPHA(2) |
Language |
Language (ISO 639 code; 2 lower-case letters) |
ALPHA(2) |
Country |
Country (ISO 3166 code; 2 upper-case letters) |
BOOL |
ReturnCode |
Return code for the operation: *TRUE if the operation was completed successfully. *FALSE if it was not. |
Example
Exemple 1:
l_Language |
= 'fr' /* Language : French */ |
l_Country |
= *BLANK / * No country code */ |
CALL_DLL 'VaToolBx' 'VaToolBxAwsSetLocale' l_Language l_Country ReturnCode
Exemple 2:
l_Language |
= 'en' /* Language : English |
l_Country |
= 'AU' /* Pays : Australia |
CALL_DLL 'VaToolBx' 'VaToolBxAwsSetLocale' l_Language l_Country ReturnCode
List of the VaToolBx functions by topic