The setLocale(Locale) method of java.util.Locale.Builder class in Java is used to reset this Locale.Builder to the specified Locale. It means that this method will reset the current state of Locale.Builder instance to match the provided Locale and return it.
Syntax:
public Locale.Builder setLocale(Locale locale)
Parameter: This method accepts the locale as the parameter which is the Locale that is to be set to this Locale.Builder instance.
Return Value: This method returns an Locale.Builder instance which is the state of this Locale.Builder set to the specified Locale.
Exception: This method throws following Exceptions:
- IllformedLocaleException: if the specified locale has any ill formed fields
- NullPointerException: if the specified locale is null
Program 1:
// Java program to demonstrate// the above method  import java.util.*;import java.util.Locale.*;  public class LocaleBuilderDemo {    public static void main(String[] args)    {          // Creating a new Locale.Builder        Locale.Builder localeBuilder            = new Builder();          // Displaying Locale.Builder        System.out.println("LocaleBuilder: "                           + localeBuilder);          // setting the locale of Locale.Builder        Locale locale = Locale.FRANCE;        System.out.println("Setting the Locale: "                           + locale);          localeBuilder            = localeBuilder.setLocale(locale);          // Displaying Locale.Builder        System.out.println("Updated LocaleBuilder: "                           + localeBuilder);    }} |
Output:
LocaleBuilder: java.util.Locale$Builder@232204a1 Setting the Locale: fr_FR Updated LocaleBuilder: java.util.Locale$Builder@232204a1
Program 2:
// Java program to demonstrate// the above method  import java.util.*;import java.util.Locale.*;  public class LocaleBuilderDemo {    public static void main(String[] args)    {          // Creating a new Locale.Builder        Locale.Builder localeBuilder            = new Builder();          // Displaying Locale.Builder        System.out.println("LocaleBuilder: "                           + localeBuilder);          // setting the locale of Locale.Builder        Locale locale = Locale.ENGLISH;        System.out.println("Setting the Locale: "                           + locale);          localeBuilder            = localeBuilder.setLocale(locale);          // Displaying Locale.Builder        System.out.println("Updated LocaleBuilder: "                           + localeBuilder);    }} |
Output:
LocaleBuilder: java.util.Locale$Builder@232204a1 Setting the Locale: en Updated LocaleBuilder: java.util.Locale$Builder@232204a1
Reference: https://docs.oracle.com/javase/9/docs/api/java/util/Locale.Builder.html#setLocale-java.util.Locale-
