Locale Sensitive Services SPI : Locales « I18N « Java Tutorial

SPI stands for service provider interface.

You can write your own implementations for most locale sensitive classes in the java.text and java.util packages for locales that are not (yet) supported by the JRE.

with the new Java 6 feature, you can provide locale-sensitive implementations for the following entities.

  1. Language and country names for the java.util.Locale class
  2. Time zone names for the java.util.TimeZone class
  3. Symbols for the java.util.Currency class

import java.text.DateFormat;
import java.text.SimpleDateFormat;
import java.text.spi.DateFormatProvider;
import java.util.Locale;
import java.text.DateFormat;
import java.util.Date;
import java.util.Locale;

public class AntarcticaLocaleDemo {
    public static void main(String [] args) {
        Date now = new Date();

        DateFormat defaultFormat = DateFormat.getDateTimeInstance();
        String defaultString = defaultFormat.format (now);
        System.out.println ("Default : " + defaultString);

        DateFormat antarcticaFormat =
                DateFormat.getDateTimeInstance (
                DateFormat.FULL, DateFormat.FULL,
                new Locale ("en", "AQ"));
        String antarcticaString = antarcticaFormat.format (now);
        System.out.println ("Antarctica: " + antarcticaString);
class DateFormatProviderImpl extends DateFormatProvider {
    private Locale antarctica = new Locale ("en", "AQ");

    public Locale[] getAvailableLocales() {
        return new Locale [] {antarctica};

    public DateFormat getTimeInstance(int style, Locale locale) {
        if (locale.equals(antarctica)) {
            return new SimpleDateFormat("HH.mm.ss");
        return null;

    public DateFormat getDateTimeInstance(int dateStyle, Locale locale) {
        if (locale.equals(antarctica)) {
            return new SimpleDateFormat("yyyy~MM~dd HH.mm.ss");
        return null;
    public DateFormat getDateTimeInstance(int dateStyle,
           int timeStyle, Locale locale) {
        if (locale.equals(antarctica)) {
            return new SimpleDateFormat("yyyy~MM~dd HH.mm.ss");
        return null;

    public DateFormat getDateInstance(int style, Locale locale) {
      if (locale.equals(antarctica)) {
        return new SimpleDateFormat("yyyy~MM~dd HH.mm.ss");
      return null;

//Java 6 New Features: A Tutorial
//by Budi Kurniawan 
//Brainy Software Corp. 2006
//Chapter 4 - Networking
//# ISBN-10: 0975212885
//# ISBN-13: 978-0975212882

13.1.2.Listing All Available Locales
13.1.3.Get the 2-letter country code; may be equal to ""
13.1.4.Get localized name suitable for display to the user
13.1.5.Setting the Default Locale on the command line
13.1.6.Set only language code on the command line
13.1.7.Set language and country code on the command line
13.1.8.Change the default locale is to call Locale.setDefault():
13.1.9.Set the default locale to pre-defined locale
13.1.10.Set the default locale to custom locale
13.1.11.format date for a Locale
13.1.12.Get a list of country names
13.1.13.Set a default Locale
13.1.14.New locales in Java 6
13.1.15.Locale Sensitive Services SPI
13.1.16.Japanese ImperialCalendar
13.1.17.Use Locale constant
13.1.18.Load Resource Bundle based on Locale Name
13.1.19.Get Display Country for default locale
13.1.20.Get ISO3 Language for default locale
13.1.21.Get Display Name for default locale
13.1.22.Get Display Variant for default locale
13.1.23.Constant Locale Usage
13.1.24.Map using Locale objects as keys
13.1.25.Calculate the postfix to append to a filename to load the correct single filename for that Locale.
13.1.26.Calculate the postfixes along the search path from the base bundle to the bundle specified by baseName and locale.
13.1.27.Converts a String to a Locale
13.1.28.Returns the parent locale of a given locale.