Java.util.Locale Class in Java | Set 1 - GeeksforGeeks

06 Aug, 2021
As the name suggests util.Locale Class is used to perform locale task and provides locale information for the user. 
Declaration : 
public final class Locale
   extends Object
   implements Cloneable, Serializable
Constructors : 
Locale(String L): Creates Locale form the given language code.
Locale(String L, String C): Creates Locale form the given language, country code.
Locale(String L, String C, String V): Creates Locale form the given language, country, variant code.
Methods: 
1. getDisplayCountry() : java.util.Locale.getDisplayCountry() return the country to which locale belongs to. 
Syntax : 
public final String getDisplayCountry()
Parameters : 
----
Return :
-----
2. getDefault() : java.util.Locale.getDefault() return the current – default value for the locale as per the JVM instance. 
Syntax : 
public static Locale getDefault()
Parameters : 
----
Return :
current - default value for the locale as per the JVM instance.
3. getCountry() : java.util.Locale.getCountry() return the country for the locale which could be empty or ISO 3166 2-letter code. 
Syntax : 
public String getCountry()
Parameters : 
----
Return :
-----
4. equals(Object locale2) : java.util.Locale.equals(Object locale2) checks whether two locales are equal or not. 
Syntax : 
public boolean equals(Object locale2)
Parameters : 
locale2 : another locale to be compare with.
Return :
returns true if two locales are equal, else false. 
5. clone() : java.util.Locale.clone() creates clone of the locale. 
Syntax : 
public Object clone()
Parameters : 
----
Return :
clone of this instance
6. getAvailableLocales() : java.util.Locale.getAvailableLocales() returns array of all the installed locales. 
Syntax : 
public static Locale[] getAvailableLocales()
Parameters : 
---
Return :
array of installed locales.
7. getDisplayLanguage() : java.util.Locale.getDisplayLanguage() returns the language with the locale. 
Syntax : 
public final String getDisplayLanguage()
Parameters : 
----
Return :
---- 
8. getDisplayLanguage(Locale in) : java.util.Locale.getDisplayLanguage(Locale in) returns the language localised according to “in” Locale if possible. 
Syntax : 
public String getDisplayLanguage(Locale in)
Parameters : 
in : the instance local
Return :
---- 
Exception :
NullPointerException : if "in" is null.
9. getDisplayName() : java.util.Locale.getDisplayName() displays name of the Locale 
Syntax : 
public final String getDisplayName()
Parameters : 
----
Return :
-----------
10. getDisplayLanguage(Locale in) : java.util.Locale.getDisplayLanguage(Locale in) returns the language of “in” locale. 
Syntax : 
public final String getDisplayLanguage()
Parameters : 
in : the instance local
Return :
---- 
11. getISO3Country() : java.util.Locale.getISO3Country() displays 3-letter abbreviation of Locale country. 
Syntax : 
public String getISO3Country()
Parameters : 
----
Return :
-------------
Java
// Java Program illustrating the use of methods :// getDisplayCountry(), getCountry(), equal(), clone(),// getAvailableLocales(), getDefault(),// getDisplayLanguage(Locale in), getDisplayLanguage(),// getDisplayName(Locale in), getDisplayName(),// getISO3Country()import java.util.*;public class NewClass{    public static void main(String[] args)    {        // Creating a new Locale        Locale geek1 = new Locale("English", "IN");         // Use of getDefault() :        Locale geek2 = Locale.getDefault();         System.out.println("Locale name : " + geek1);        System.out.println("Locale name Default : " + geek2);         // Use of getDisplayCountry() :        System.out.println("\nCountry Name : "                            + geek1.getDisplayCountry());         // Use of getCountry() :        System.out.println("Country Name ISO 3166 2-letter code : "                                            + geek1.getCountry());         // Use of equal() :        System.out.println("\nIs geek1 equals geek2 : "                                 + geek1.equals(geek2));         // clone() : geek3 is a clone of geek2        Locale geek3 = (Locale) geek2.clone();         // Locale : geek3        System.out.println("Locale geek3 same as geek2 : "                                                + geek3);         // Use of getAvailableLocales()        Locale[] geek4 = Locale.getAvailableLocales();         // We are not printing all the locales.        System.out.println("\nInstalled locales are : ");        for (int i = 1; i < geek4.length/10; i++)            System.out.println(i + ":" + geek4[i]);         // Use of getDisplayLanguage() :        System.out.println("\ngeek2 Language : "                        + geek2.getDisplayLanguage());         // Use of getDisplayLanguage(Locale in) :        System.out.println("Language of in Locale : "          + geek1.getDisplayLanguage(new Locale("France", "French")));         // Use of getDisplayName :        System.out.println("\nUse of getDisplayName : "                              + geek1.getDisplayName());         // Use of getDisplayName(Locale in) :        System.out.println("Name of in Locale : "          + geek2.getDisplayName(new Locale("English", "english")));         // Use of getISO3Country() :        System.out.println("\nISO3 Country Name of geek3 : "                                    + geek3.getISO3Country());     }}
Output : 
Locale name : english_IN
Locale name Default : en_US

Country Name : India
Country Name ISO 3166 2-letter code : IN

Is geek1 equals geek2 : false
Locale geek3 same as geek2 : en_US

Installed locales are : 
1:ar_AE
2:ar_JO
3:ar_SY
4:hr_HR
5:fr_BE
6:es_PA
7:mt_MT
8:es_VE
9:bg
10:zh_TW
11:it
12:ko
13:uk
14:lv
15:da_DK

geek2 Language : English
Language of in Locale : english

Use of getDisplayName : english (India)
Name of in Locale : English (United States)

ISO3 Country Name of geek3 : USA
Next: Java.util.Locale Class in Java | Set 2
This article is contributed by Mohit Gupta_OMG . If you like GeeksforGeeks and would like to contribute, you can also write an article using write.geeksforgeeks.org or mail your article to review-team@geeksforgeeks.org. See your article appearing on the GeeksforGeeks main page and help other Geeks.Please write comments if you find anything incorrect, or you want to share more information about the topic discussed above. 
arorakashish0911
Java - util package
Java
Java
Writing code in comment?
Please use ide.geeksforgeeks.org,
generate link and share the link here.
HashMap in Java with Examples
Stream In Java
Interfaces in Java
How to iterate any Map in Java
ArrayList in Java
Initialize an ArrayList in Java
Stack Class in Java
Multidimensional Arrays in Java
Singleton Class in Java
Set in Java