Utilizar métodos de configuración regional neutros en código

Disponible en: Salesforce Classic y Lightning Experience

Disponible en: todas las ediciones

Para buscar su código de Salesforce, descargue los metadatos. Luego utilice una interfaz de línea de comandos como Salesforce CLI.

La configuración regional de un usuario determina los formatos para estos tipos de datos: dirección, divisa, fecha, fecha y hora, nombre, entero y hora. El día de inicio de la semana también se basa en la configuración regional del usuario.

Cuando migra desde los formatos de configuración regional de Java Development Kit (JDK) de Oracle a los formatos de configuración regional Componentes internacionales para Unicode (ICU), los formatos de divisa, fecha, fecha y hora, entero y hora cambian para algunas configuraciones regionales.

Además, los formatos de configuración regional se actualizan regularmente para coincidir con los estándares internacionales más recientes. Además, los usuarios pueden actualizar su configuración regional para que coincida con su ubicación o preferencia actual.

Para evitar problemas con su código personalizado debido a cambios de formato de configuración regional, siga estas directrices.

• Utilice métodos estándar para llamar a estos formatos. Por ejemplo, cuando se gestionan fechas en Apex, utilice el tipo de datos Fecha.
• Cuando trabaje estos tipos de datos en su código, utilice métodos estándar para extraer componentes. Por ejemplo, cuando desea extraer el mes de un formato de fecha en Apex, utilice el método month() en la clase Fecha. Del mismo modo, gestione valores enteros y de divisa como enteros sin formato hasta que deba asignarles formato.
• Si su código realiza procesamiento adicional en un valor, utilice un formato local neutro. Por ejemplo, en Apex, utilice format(string dataFormat) o format(string dataFormat, string timezone).
• Haga que la transformación de datos en el formato de configuración regional preferido del usuario sea el último paso en la gestión de esos datos. Por ejemplo, cuando calcule una fecha futura en Apex, utilice el método format() de la clase de fecha después del cálculo.
• Métodos de format() Apex, como valores de devolución de DateTime.format() en la configuración regional del usuario de contexto. Si el código siguiente espera datos en un formato de configuración regional concreto, especifique el formato explícitamente. Por ejemplo, para pasar una hora en un formato como 10:15 a en Apex, utilice DateTime.format('h:mm a'). Debido a que este ejemplo pasa el argumento de cadena 'h:mm a' a la función de formato, la fecha y hora tienen formato según el formato suministrado independientemente de la configuración regional del contexto de usuario.
• Cuando cree listas delimitadas, ponga cualquier dato de configuración regional que pueda incluir una coma entre comillas.

A continuación se muestran algunos ejemplos de código que devuelven formatos en el formato de configuración regional preferido del usuario.

• Apex: el método format() en las clases Date, DateTime y Integer
• Componentes Lightning Aura: la variable global $Locale
• Propiedades de Internacionalización de componentes web Lightning