Converts a String to a Locale : Locale « I18N « Java

Converts a String to a Locale

// Copyright 2008 The Apache Software Foundation
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
// You may obtain a copy of the License at
// Unless required by applicable law or agreed to in writing, software
// distributed under the License is distributed on an "AS IS" BASIS,
// See the License for the specific language governing permissions and
// limitations under the License.

import java.util.Locale;

 * Contains code borrowed from <a href="">commons-lang</a>.
public class LocaleUtils
     * <p>Converts a String to a Locale.</p> <p/> <p>This method takes the string format of a locale and creates the
     * locale object from it.</p> <p/>
     * <pre>
     *   LocaleUtils.toLocale("en")         = new Locale("en", "")
     *   LocaleUtils.toLocale("en_GB")      = new Locale("en", "GB")
     *   LocaleUtils.toLocale("en_GB_xxx")  = new Locale("en", "GB", "xxx")   (#)
     * </pre>
     * <p/> <p>(#) The behaviour of the JDK variant constructor changed between JDK1.3 and JDK1.4. In JDK1.3, the
     * constructor upper cases the variant, in JDK1.4, it doesn't. Thus, the result from getVariant() may vary depending
     * on your JDK.</p> <p/> <p>This method validates the input strictly. The language code must be lowercase. The
     * country code must be uppercase. The separator must be an underscore. The length must be correct. </p>
     * @param input the locale String to convert, null returns null
     * @return a Locale, null if null input
     * @throws IllegalArgumentException if the string is an invalid format
    public static Locale toLocale(String input)
        if (input == null)
            return null;

        int len = input.length();
        if (len != 2 && len != 5 && len < 7)

        char ch0 = input.charAt(0);
        char ch1 = input.charAt(1);

        if (ch0 < 'a' || ch0 > 'z' || ch1 < 'a' || ch1 > 'z')

        if (len == 2)
            return new Locale(input, "");

        if (input.charAt(2) != '_')

        char ch3 = input.charAt(3);
        if (ch3 == '_')
            return new Locale(input.substring(0, 2), "", input.substring(4));

        char ch4 = input.charAt(4);
        if (ch3 < 'A' || ch3 > 'Z' || ch4 < 'A' || ch4 > 'Z')

        if (len == 5)
            return new Locale(input.substring(0, 2), input.substring(3, 5));

        if (input.charAt(5) != '_')

        return new Locale(input.substring(0, 2), input.substring(3, 5), input.substring(6));

    private static void fail(String input)
        throw new IllegalArgumentException(String.format("Unable to convert '%s' to a Locale instance.", input));



Related examples in the same category

1.List Locales from Locale.getAvailableLocales()List Locales from Locale.getAvailableLocales()
2.List all Locale from SimpleDateFormatList all Locale from SimpleDateFormat
3.Locale Constant
4.Country Language CodesCountry Language Codes
5.Get Days Of The Week for different localeGet Days Of The Week for different locale
6.Get Display Country for default localeGet Display Country for default locale
7.Get ISO3 Language for default localeGet ISO3 Language for default locale
8.Get Display Name for default localeGet Display Name for default locale
9.Get Display Variant for default localeGet Display Variant for default locale
10.Get the 2-letter country code; may be equal to ""
11.List Locale OrientationList Locale Orientation
12.Get localized name suitable for display to the user
13.Setting the Default Locale on the command line
14.Set language and country code on the command line
15.Change the default locale is to call Locale.setDefault():
16.Set the default locale to pre-defined locale
17.Set the default locale to custom locale
18.format date for a Locale
19.Get a list of country names
20.Set only language code on the command line
21.Set a default Locale
22.Disable localization
23.Set of convenience routines for internationalized code
24.Print the default locale
25.Change the default locale
28.Converts the double value to locale-independent string representation
29.Calculate the postfix to append to a filename to load the correct single filename for that Locale.
30.Calculate the postfixes along the search path from the base bundle to the bundle specified by baseName and locale.
31.Concat postfix to the name. Take care of existing filename extension.
32.Convert a string based locale into a Locale Object
33.Obtains an unmodifiable set of installed locales.
34.Obtains the list of languages supported for a given country.
35.Obtains the list of locales to search through when performing a locale search.
36.Parse the given localeString into a java.util.Locale
37.Returns the parent locale of a given locale.
38.This program demonstrates collating strings under various locales.This program demonstrates collating strings under various locales.
39.This program demonstrates formatting dates under various locales.This program demonstrates formatting dates under various locales.
40.This program demonstrates formatting numbers under various locales.This program demonstrates formatting numbers under various locales.
41.Builds a Locale instance from the passed string.
42.Utility class providing methods to access the Locale of the current thread and to get Localised strings.