Locale : Java Glossary

a geographic or political region that shares the same language and customs. Programs can be customised to a language, country and style. Locales have been given standard identifiers, e.g. Locale.CANADA, Locale. CANADA_FRENCH, Locale. FRANCE and Locale.US. These are not the same as country codes. There are four main ways to get a java.util.Locale:

java.text.NumberFormat uses the current locale by default. You can create a locale specific formatter with:

import java.text.Numberformat;
//...
NumberFormat nf = NumberFormat.getNumberInstance( someLocale );

You can use that NumberFormat both for input (parsing) and output (formatting):

java.text.DecimalFormatSymbols lets you get and set the individual characters such as getDecimalSeparator() and getGroupingSeparator(). You can translate Strings, Audioclips and Images used by your programs and pack them into java.util.ResourceBundles.

You can set the Locale three different ways:

use the "-Duser.country=us" "-Duser.language=en" options to set the system properties on the java.exe command line.
Use Locale.setDefault.
Set the locale in the Windows Control Panel.

Gotchas

Locale.setDefault ( Locale. ITALY) will not have any effect on SimpleDateFormat objects already created. You need to set the default Locale before creating your SimpleDateFormat objects or use the SimpleDateFormat constructor that takes a Locale.

Learning More

Sun’s tutorial on Localisation

Sun’s Javadoc on Locale class : available:

on the web at java.sun.com
in the current JDK 1.6.0_17 or in the old JDK 1.5.0_22 on your local Windows J: drive.

Sun’s Javadoc on NumberFormat class : available:

on the web at java.sun.com
in the current JDK 1.6.0_17 or in the old JDK 1.5.0_22 on your local Windows J: drive.

country codes
currency codes
language codes
localisation
ResourceBundle
translation

	You can get the freshest copy of this page from:	or possibly from your local J: drive (Java virtual drive/mindprod.com website mirror)
	http://mindprod.com/jgloss/locale.html	J:\mindprod\jgloss\locale.html
	Please email your feedback for publication, errors, omissions, typos, formatting errors, ambiguities, unclear wording, broken/redirected link reports, suggestions to improve this page or comments to Roedy Green :
	Canadian Mind Products
	mindprod.com IP:[65.110.21.43]
view Blog	Your face IP:[38.107.191.100]
Feedback	You are visitor number 18,590.