La función del sistema
SysLib.setLocale se utiliza en PageHandlers y en
los programas de tipo VGWebTransaction. La función establece el entorno local
Java, que
determina los siguientes aspectos del comportamiento de ejecución:
- El idioma utilizado para etiquetas y mensajes
- Los formatos de fecha y hora por omisión
Puede presentar una lista de idiomas en una página Web, por ejemplo, y establecer el entorno local Java en función de la selección del usuario. El nuevo entorno local
Java se
utilizará hasta que se produzca una de las siguientes situaciones:
- Se invoca de nuevo SysLib.setLocale; o bien
- Finaliza la sesión del navegador; o
- Si la página Web se ha presentado como resultado de que el usuario ha emitido una sentencia
converse desde el programa actual de tipo VGWebTransaction, el usuario
somete un formulario o pulsa un enlace que no invoca de nuevo ese programa; o
- Si la página Web se ha presentado como resultado de que el usuario ha emitido una sentencia
show con una cláusula de retorno, el usuario somete un formulario o pulsa
un enlace que no invoca de nuevo el programa que la sentencia indicaba que se invocaría; o
- Se presenta una nueva página Web.
En los casos mencionados, la próxima página Web volverá (por omisión) al entorno local Java especificado en el navegador.
Si el usuario somete un formulario o pulsa un enlace que abre una ventana
nueva, el entorno local
Java
de la ventana original no resulta afectado por el entorno local de la ventana nueva.
SysLib.setLocale se ajusta a la documentación de la API del JDK 1.1 y 1.2 para la clase java.util.Locale. Consulte el ISO 639 para conocer los códigos de idioma y el ISO 3166 para conocer los códigos de país.
SysLib.setLocale(
códigoIdioma CHAR(2) in,
códigoPaís CHAR(2) in
[, variante CHAR(2) in])
- códigoIdioma
- Un código de idioma de dos caracteres especificado como literal o contenido en un elemento de tipo CHAR. Sólo son válidos los códigos de idioma definidos en el ISO 639.
- códigoPaís
- Un código de país de dos caracteres especificado como literal o contenido en un elemento de tipo CHAR. Sólo son válidos los códigos de país definidos en el ISO 3166.
- variante
- Una variante, que es un código especificado como literal o contenido en un elemento de tipo CHAR. Este código no forma parte de una especificación Java, sino que depende del navegador y de otros aspectos del entorno del usuario.