Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / Java

Locale — idioma e região

Locale descreve o contexto linguístico e regional utilizado por operações sensíveis às definições regionais.

Versão: Java SE 21; repository runtime, production runtime not attested

Sintaxe

import java.util.Locale;
Locale locale = Locale.US;
Locale custom = Locale.of("en", "US");

java.util.Locale identifica um idioma e, opcionalmente, uma região; por si só, não formata dados.

Locale.ROOT é neutro em termos de idioma e região. Locale.US representa inglês nos EUA, Locale.FRANCE representa francês em França e Locale.ENGLISH representa inglês sem uma região especificada.

O construtor Locale(String,String), por exemplo new Locale("en", "US"), está obsoleto desde Java 19. Em Java SE 21, prefere Locale.of("en", "US"). Ambos normalizam maiúsculas e minúsculas, mas não validam a sintaxe dos códigos; para essa validação, utiliza Locale.Builder.

Passa um locale explicitamente, em vez de depender da predefinição do ambiente.

Exemplos

import java.util.Locale;

public class Main {
    public static void main(String[] args) {
        for (Locale locale : new Locale[] {
                Locale.ROOT, Locale.US, Locale.FRANCE, Locale.ENGLISH }) {
            System.out.println(locale.toLanguageTag());
        }
        System.out.println(Locale.of("en", "US").equals(Locale.US));
    }
}

Resultado

und
en-US
fr-FR
en
true

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes