Pierwsze spotkanie z lokalizacją

     NumberFormat nf = NumberFormat.getInstance();
     nf.setMaximumFractionDigits(3);
     String wynik = nf.format(d);
     System.out.println(wynik);

3,333

3.333

Lokalizacje

Locale[] loc = Locale.getAvailableLocales();

Locale dloc = Locale.getDefault();

Locale newDefLoc = new Locale(...);
Locale.setDefault(newDefLoc)

    get...Instance()

    bez argumentu, określającego lokalizację.

import java.text.*;
import java.util.*;

public class DefLok {

  static public void report() {
    Locale defLoc = Locale.getDefault();
    System.out.println("Domyślna lokalizacja : " + defLoc);
    DateFormat df = DateFormat.getDateInstance(DateFormat.LONG);
    NumberFormat nf = NumberFormat.getInstance();
    System.out.println(df.format(new Date()));
    System.out.println(nf.format(1234567.1));
  }

  public static void main(String[] args) {
    report();
    Locale.setDefault(new Locale("en"));
    report();
  }

}

     get...Instance(...)

     z argumentem typu Locale - określającym konkretną lokalizację.

import java.text.*;
import java.util.*;

public class MiscLok {

  public static void main(String[] args) {
    System.out.println("Domyślna lokalizacja : " + Locale.getDefault());
    DateFormat df = DateFormat.getDateInstance(DateFormat.LONG);
    System.out.println(df.format(new Date()));
    double num = 123.4;
    NumberFormat nf = NumberFormat.getInstance();
    System.out.println("Liczba " + num +
                       " w lokalizacji domyślnej: " + nf.format(num));
    nf = NumberFormat.getInstance(new Locale("en"));
    System.out.println("Liczba " + num +
                       " w lokalizacji angielskiej: " + nf.format(num));
  }

}

import java.util.*;
import java.text.*;
import javax.swing.*;

class CountryTranslator {

  public static void main(String[] args) {

    Locale[] loc = Locale.getAvailableLocales();
    Map map = new HashMap();
    String kraj;

    // Dodanie dostępnych lokalizacji do mapy
    // klucz: nazwa kraju po polsku, wartośc - lokealizacja
    for (int i=0; i<loc.length; i++) {
      String countryCode = loc[i].getCountry();  // kod kraju
      if (countryCode.equals("")) continue;
      kraj =  loc[i].getDisplayCountry();
      map.put(kraj, loc[i]);
    }

    String msg = "Podaj kraj";
    String in = "";
    while((kraj = JOptionPane.showInputDialog(msg)) != null ) {
      // Pobieramy lokalizację dla podanego kraju
      Locale savedLoc = (Locale) map.get(kraj);
      if (savedLoc == null) continue;
      msg = "Podaj kody języków, rozdzielone spacjami";
      while((in = JOptionPane.showInputDialog(null, msg, in)) != null ) {
        StringTokenizer st = new StringTokenizer(in);
        if (st.countTokens() == 0) continue;
        String rep = "Nazwa kraju " + kraj + ":\n";

        // Dla kolejnych kodów języków
        // uzyskujemy nazwę kraju w języku odpowiadającym
        // lokalizacji związanej z kodem jęsyka
        while(st.hasMoreTokens()) {
          Locale lang = new Locale(st.nextToken());
          rep += lang.getDisplayLanguage() + "   =   " +
                 savedLoc.getDisplayCountry(lang) + "\n";
        }
      JOptionPane.showMessageDialog(null,rep);
      }
      msg = "Podaj kraj";
    }
    System.exit(0);
  }
}

Formatowanie liczb

• stworzyć obiekt klasy DecimalFormat, podając jako argument konstruktora wzorzec formatowania,
• wywołać metodę format na rzecz tego obiektu.

     double d = 10/3.0;
     DecimalFormat dform = new DecimalFormat("###.###");
     String wynik = dform.format(d);
     System.out.println(wynik);

import java.text.*;
import java.math.*;

public class Format1 {

  public static void show(double n1, Double n2, BigDecimal n3,
                          String format) {
    DecimalFormat df = new DecimalFormat(format);
    System.out.println("Format " + format);
    System.out.println("Liczba: " +  n1 + " wygląda tak: " + df.format(n1));
    System.out.println("Liczba: " +  n2 + " wygląda tak: " + df.format(n2));
    System.out.println("Liczba: " +  n3 + " wygląda tak: " + df.format(n3));
  }


  public static void main(String[] args) {
    double num1  = 1.346;
    Double num2  = new Double(0.765474);
    BigDecimal num3 = new BigDecimal("100.2189091");

    show(num1, num2, num3, "#.##");
    show(num1, num2, num3, "#.## %");
    show(num1, num2, num3, "#.0000");
    show(num1, num2, num3, "#.00 ¤");
    show(num1, num2, num3, "#.00 ¤¤");
    show(num1, num2, num3, "[ 000.0 ]");

 }

}

    DecimalFormat df = (DecimalFormat)
                       NumberFormat.getInstance(new Locale("en", "US"));
    df.applyPattern(format);

DecimalFormat df = new DecimalFormat(format);  // formator w domyślnej lokalizacji
DecimalFormatSymbols sym = df.getDecimalFormatSymbols(); // symbole
sym.setDecimalSeparator('.');                  // ustalenie separatora miejsc dziesiętnych

• liczb całkowitych - metoda NumberFormat.getIntegerInstance(...)
• wartości wyrażonych w walucie - metoda NumberFormat.getCurrencyInstance(...)
• wartości w procentach - metoda NumberFormat.getPercentInstance(...)

• zwraca referencję do obiektu podklasy klasy Number, który - w zależności od wartości interpretowanego napisu może wskazywać na Long lub Double,
• napis podlega interpretacji jako liczba zgodnie z  lokalizacją (np. w polskiej lokalizacji użycie przecinka jako separatora miejsc dziesiętnych),
• w zależności od zastosowanego formatu w trakcie interpretacji napisu może wystąpić wyjątek ParseException (albo interpretacja będzie przebiegać "dopóki się da", a nie pasujące znaki będą pominięte).
  

  public static void main(String[] args) {
    NumberFormat format = new DecimalFormat("[ #.0000 ]");
    //...
    while ((in = JOptionPane.showInputDialog(msg)) != null) {
      System.out.println("Wejscie: " + in);
      try {
        num = format.parse(in);
      } catch (ParseException exc) {
          System.out.println("Wadliwe dane: " + in);
          System.out.println(exc);
          System.out.println("Wadliwa pozycja: " + exc.getErrorOffset());
          continue;
      }
      System.out.println("Parse daje: " +
                          num.getClass().getName()+ " = " + num);
    }
  }

.import java.io.*;
import java.text.*;
import java.util.*;

public class Parse2 {

  public static void main(String[] args) {

    // Format walutowy w domyślnej lokalizacji
    // czyli w PL np. 12 zł
    NumberFormat format = NumberFormat.getCurrencyInstance();

    // Lista wartości wydatków (zapisanych w tekście pliku)
    List numList = new ArrayList();

    try {
      BufferedReader br = new BufferedReader(
                            new FileReader("testdata.txt")
                          );

      // czytanie kolejnych wierszu
      String in;
      while ((in = br.readLine()) != null) {

        int p = 0;                    // bieżący indeks rozbioru
        int last  = in.length() - 1;  // ostatni indeks w wierszu

        // Utworzenie pozycji rozbioru wiersza (od 0)
        ParsePosition ppos = new ParsePosition(0);

        // Dopóki nie dobiegliśmy do końca wiersza
        while (p <= last) {
           // Próbujemy pobrać kolejną liczbę w formacie walutowym
           Number num = format.parse(in, ppos);

           if (num == null)              // jeżeli błąd,
             p = ppos.getErrorIndex()+1; // indeks na znaku po błędzie
           else {                        // jeżeli udało się sczytać wartość
             numList.add(num);           // dodajemy ją do listy
             p =  ppos.getIndex();   // indeks na następnym znaku po
           }
           ppos.setIndex(p);         // ustawiamy następną pozycję
        }                            // od której kontynuacja rozbioru
      }
      br.close();
    } catch(Exception exc) {
        exc.printStackTrace();
        System.exit(1);
    }

    // Wypisanie i podsumowanie zapisanych w pliku wydatków
    System.out.println("Wydatki w zł:");
    double suma = 0;
    for (Iterator iter = numList.iterator(); iter.hasNext(); ) {
      Number val  = (Number) iter.next();
      System.out.println(val);
      suma += val.doubleValue();
    }
    System.out.println("Wydano w sumie: " + format.format(suma));
  }
}

import java.io.*;
import java.text.*;
import java.util.*;

public class Parse2j5 {

  public static void main(String[] args) {

    // Format walutowy w domyślnej lokalizacji
    // czyli w PL np. 12 zł
    NumberFormat format = NumberFormat.getCurrencyInstance();

    // Lista wartości wydatków (zapisanych w tekście pliku)
    // GENERIC!!!
    List<Double> numList = new ArrayList<Double>();

    try {
      BufferedReader br = new BufferedReader(
                            new FileReader("testdata.txt")
                          );

      // czytanie kolejnych wierszu
      String in;
      while ((in = br.readLine()) != null) {

        int p = 0;                    // bieżący indeks rozbioru
        int last  = in.length() - 1;  // ostatni indeks w wierszu

        // Utworzenie pozycji rozbioru wiersza (od 0)
        ParsePosition ppos = new ParsePosition(0);

        // Dopóki nie dobiegliśmy do końca wiersza
        while (p <= last) {
           // Próbujemy pobrać kolejną liczbę w formacie walutowym
           Number num = format.parse(in, ppos);

           if (num == null)              // jeżeli błąd,
             p = ppos.getErrorIndex()+1; // indeks na znaku po błędzie
           else {                        // jeżeli udało się sczytać wartość
             numList.add(num.doubleValue()); // BOXING!!!
             p =  ppos.getIndex();   // indeks na następnym znaku po
           }
           ppos.setIndex(p);         // ustawiamy następną pozycję
        }                            // od której kontynuacja rozbioru
      }
      br.close();
    } catch(Exception exc) {
        exc.printStackTrace();
        System.exit(1);
    }

    // Wypisanie i podsumowanie zapisanych w pliku wydatków
    System.out.println("Wydatki w zł:");
    double suma = 0;
    for( Double val : numList ) { // FOR-EACH
      System.out.println(val);
      suma += val; // UNBOXING!!!
    }

    /*for (Iterator iter = numList.iterator(); iter.hasNext(); ) {
      Number val  = (Number) iter.next();
      System.out.println(val);
      suma += val.doubleValue();
    }*/

    System.out.println("Wydano w sumie: " + format.format(suma));
  }
}

• SPELLOUT - przedstawianie liczb w postaci słownej,
• ORDINAL - przedstawianie liczb jako liczebników porządkowych (z odpowiednimi końcówkami),
• DURATION -  przekształcanie liczb na jednostki czasu (godziny, minuty, sekundy).

Waluty

Strefy czasowe

import java.util.*;
import java.awt.*;
import java.awt.event.*;
import javax.swing.*;

public class Strefy1 {

  public static void main(String[] args) {

    // Konstruowanie stref czasowych
    TimeZone myTz = TimeZone.getTimeZone("Europe/Warsaw");
    TimeZone java = TimeZone.getTimeZone("Asia/Jakarta");
    TimeZone cuba = TimeZone.getTimeZone("America/Havana");

    // za pomocą pokazanej dalej metody getDiffMsg
    // wyliczamy i pokazujemy aktualną różnicę czasu
    // pomiędzy sterfami czasowymi

    System.out.println(getDiffMsg(myTz, java));
    System.out.println("--------------------------------------------------");
    System.out.println(getDiffMsg(myTz, cuba));
    System.out.println("--------------------------------------------------");
    System.out.println(getDiffMsg(cuba, java));
    System.out.println("--------------------------------------------------");

    // Jakie strefy czasowe mają podaną różnicę czasu wobec GMT

   for (int k = 12; k <= 14; k++) {
     String[] ids = TimeZone.getAvailableIDs(k*3600000);
     Arrays.sort(ids);
     System.out.println(
      "Strefy czasowe mające różnice +" + k + " godzin wobec GMT" );
     for (int i=0; i < ids.length; i++) {
       System.out.println(ids[i]);
     }
     System.out.println("--------------------------------------------------");
   }
  }

  static String getDiffMsg(TimeZone z1, TimeZone z2) {
    Date data = new Date();
    long teraz = data.getTime();
    double offset1 = z1.getOffset(teraz)/3600000.0;
    double offset2 = z2.getOffset(teraz)/3600000.0;
    double diff;
    if (offset1 > offset2)  diff = -(offset1 - offset2);
    else diff = offset2 - offset1;
    String out =  "Różnica czasu pomiędzy" + '\n' +
                  z1.getID() + " i " + z2.getID()  + '\n' +
                  "wynosi teraz : " + diff + " godz."  + '\n' +
                  "W strefie " + z1.getID() +
                       (z1.inDaylightTime(data) ? " " : " nie ") +
                       "działa czas letni"  + '\n' +
                  "W strefie " + z2.getID() +
                       (z2.inDaylightTime(data) ? " " : " nie ") +
                       "działa czas letni";

    return out;
  }

}

Kalendarze

import java.util.*;

public class Kal1 {

  public static void say(String s) { System.out.println(s+'\n'); }

  public static void main(String[] args) {

    // uzyskanie kalendarza domyślnego
    // (obowiązującgo dla domyślnej lokalizacji - tu dla Polski)
    // ustawionego na bieżącą datę i czas

    Calendar cal = Calendar.getInstance();

    say("ERA.............. " + cal.get(Calendar.ERA) +
        " (tu: 0=pne, 1=AD)");

    say("ROK.............. " + cal.get(Calendar.YEAR));
    say("MIESIĄC.......... " + cal.get(Calendar.MONTH) +
        " (0-styczeń, 2-luty, ..., 11-grudzień)");

    say("LICZBA DNI\n" +
        "W MIESIĄCU....... " + cal.getActualMaximum(Calendar.DAY_OF_MONTH));

    say("DZIEŃ MIESIĄCA... " + cal.get(Calendar.DAY_OF_MONTH));
    say("DZIEŃ MIESIĄCA... " + cal.get(Calendar.DATE));
    say("TYDZIEŃ ROKU..... " + cal.get(Calendar.WEEK_OF_YEAR));
    say("TYDZIEŃ MIESIĄCA. " + cal.get(Calendar.WEEK_OF_MONTH));
    say("DZIEŃ W ROKU..... " + cal.get(Calendar.DAY_OF_YEAR));

    say("PIERWSZY DZIEŃ\n" +
        "TYGODNIA......... " + cal.getFirstDayOfWeek() +
        " (1-niedziela, 2-poniedziałek, ..., 7 sobota)");

    say("DZIEŃ TYGODNIA... " + cal.get(Calendar.DAY_OF_WEEK) +
        " (1-niedziela, 2-poniedziałek, ..., 7-sobota)");

    say("GODZINA.......... " + cal.get(Calendar.HOUR) +
        " (12 godzinna skala; następne odwolanie czy AM czy PM)");

    say("AM/PM............ " + cal.get(Calendar.AM_PM) +
        " (AM=0, PM=1)");

    say("GODZINA.......... " + cal.get(Calendar.HOUR_OF_DAY) +
        " (24 godzinna skala)");

    say("MINUTA........... " + cal.get(Calendar.MINUTE));
    say("SEKUNDA.........  " + cal.get(Calendar.SECOND));
    say("MILISEKUNDA:      " + cal.get(Calendar.MILLISECOND));

    int msh = 3600*1000; // liczba milisekund w godzinie

    say("RÓŻNICA CZASU\n" +
        "WOBEC GMT........ " + cal.get(Calendar.ZONE_OFFSET)/msh);

    say("PRZESUNIĘCIE\n" +
        "CZASU............ " + cal.get(Calendar.DST_OFFSET)/msh +
        " (w Polsce obowiązuje w lecie)");

  }

}

ERA.............. 1 (tu: 0=pne, 1=AD)

ROK.............. 2003

MIESIĄC.......... 4 (0-styczeń, 2-luty, ..., 11-grudzień)

LICZBA DNI
W MIESIĄCU....... 31

DZIEŃ MIESIĄCA... 6

DZIEŃ MIESIĄCA... 6

TYDZIEŃ ROKU..... 19

TYDZIEŃ MIESIĄCA. 2

DZIEŃ W ROKU..... 126

PIERWSZY DZIEŃ
TYGODNIA......... 2 (1-niedziela, 2-poniedziałek, ..., 7 sobota)

DZIEŃ TYGODNIA... 3 (1-niedziela, 2-poniedziałek, ..., 7-sobota)

GODZINA.......... 6 (12 godzinna skala; następne odwolanie czy AM czy PM)

AM/PM............ 1 (AM=0, PM=1)

GODZINA.......... 18 (24 godzinna skala)

MINUTA........... 5

SEKUNDA.........  0

MILISEKUNDA:      550

RÓŻNICA CZASU
WOBEC GMT........ 1

PRZESUNIĘCIE
CZASU............ 1 (w Polsce obowiązuje w lecie)

• set - ustala wartość pola; jeśli trzeba  dostosowując inne pola (np. ustawienie pola DAY_OF_MONTH na wartość 31 dla kalendarza ustawionego na dowolną datę w czerwcu spowoduje, że kalendarz będzie wskazywał na 1 lipca, gdyż w czerwcu jest tylko 30 dni),
• add  - dodaje do pola podaną wartość, stosując przy tym arytmetykę kalendarzową (np. dodanie do 30 maja 2 dni spowoduje ustawienie kalendarza na  1 czerwca),
• roll - również wykonuje dodawanie, ale przy tym nie zmienia wartości "starszych" pól np. jeżeli dodajemy dni i okaże się, że nowa data znajdzie się w innym niż teraz miesiącu, to miesiąc nie zostanie zmieniony, zaś "nadwyżka" dni (poza końcem bieżącego miesiąca) będzie dodawana od początku miesiąca.

• dla domyślnej lokalizacji, ale ustawiony na podaną strefę czasową (Calendar.getInstance(TimeZone)),
• dla podanej lokalizacji (Calendar.getInstance(Locale)),
• dla podanej lokalizacji i strefy czasowej (Calendar.getInstance(TimeZone,Locale)),

    TimeZone tz = TimeZone.getTimeZone("Asia/Jakarta");
    Calendar c = Calendar.getInstance(tz);
    System.out.println("Current time: " + c.getTime());
    System.out.println("Java time: " +
         c.get(Calendar.HOUR_OF_DAY) + ":" + c.get(Calendar.MINUTE));

    Calendar c = Calendar.getInstance();
    System.out.println(c.getClass().getName());
    c = Calendar.getInstance(new Locale("th", "TH"));
    System.out.println(c.getClass().getName());

import com.ibm.icu.util.*;
import com.ibm.icu.text.*;

public class MiscCal {

  public static void main(String[] args) {
    Calendar[] kal = {
               Calendar.getInstance(),   // domyślny kalendarz - gregoriański
               new GregorianCalendar(),  // jeszcze raz - ale inaczej tworzony
               new BuddhistCalendar(),   // buddyjski
               new ChineseCalendar(),    // chiński
               new JapaneseCalendar(),   // japoński
               new IslamicCalendar(),    // islamski
               new HebrewCalendar(),     // hebrajski
               };
    java.util.Date teraz = new java.util.Date(); // aktualny czas
    System.out.println("Teraz jest: " + teraz);  // po angielsku

    // przebiegamy po klaendarzach
    // ustawiamy je na bieżący czas
    // i pokazujemy wartości takich pól jak rok, miesiąc itp.

    for (int i=0; i<kal.length; i++) {
      kal[i].setTime(teraz);
      String className = kal[i].getClass().getName();
      String name = className.substring(className.lastIndexOf(".") + 1);
      System.out.println(name + " - " +
            "era " + kal[i].get(Calendar.ERA) +
            "; rok " + kal[i].get(Calendar.YEAR) +
            (name.equals("ChineseCalendar") ?
                  " czyli " + kal[i].get(Calendar.EXTENDED_YEAR)  : "") +
            "; mies " + kal[i].get(Calendar.MONTH) +
            "; dzień mies. " + kal[i].get(Calendar.DAY_OF_MONTH) +
            "; dzień tyg. " + kal[i].get(Calendar.DAY_OF_WEEK)
            );
    }
  }

}

Formatowanie dat

• formator dla dat - metody getDateInstance(...)
• formator dla czasu - metody getTimeInstance(...)
• formator dla daty i czasu - metody getDateTimeInstance(...)
• domyślny formator dla daty i czasu - metoda getInstance().

import java.util.*;

public class Daty1 {

  public static void main(String[] args) {

    Calendar c = Calendar.getInstance();
    Date teraz = c.getTime();

    SimpleDateFormat df = (SimpleDateFormat) DateFormat.getDateInstance();

    String[] pattern = {"dd-MM-yyyy",
                        "MMMM, 'dzień 'dd ( EE ), 'roku 'yyyy GGGG",
                        "EEEE, dd MMM yyyy 'r.'"
                       };
    for (int i=0; i<pattern.length; i++) {
      df.applyPattern(pattern[i]);
      System.out.println(df.format(teraz));
    }

  }

}

   public static void main(String[] args) {


    SimpleDateFormat df = (SimpleDateFormat) DateFormat.getDateInstance();

    String[] pattern = {"dd-MM-yyyy",
                        "MMMM, 'dzień 'dd ( EE ), 'roku 'yyyy GGGG",
                        "EEEE, dd MMM yyyy 'r.'"
                       };

    for (int i=0; i<pattern.length; i++) {

      String in=JOptionPane.
                showInputDialog("Wprowadź datę wg wzorca " + pattern[i]);
      df.applyPattern(pattern[i]);
      Date data = df.parse(in, new ParsePosition(0));
      System.out.println(data);
    }
  }

import java.util.*;
import java.text.*;
import java.awt.*;
import javax.swing.*;

public class DateFormatSymbolsShow {

  String[] lang = { "fr", "es", "de", "ru" };

  String out = "";

  public DateFormatSymbolsShow() {
    for (int i=0; i<lang.length; i++) {
      Locale  loc = new Locale(lang[i]);
      DateFormatSymbols dfs = new DateFormatSymbols(loc);
      out += '\n' + loc.getDisplayLanguage();
      // nazwy er
      addToOut("Ery: ", dfs.getEras());
      // nazwy miesięcy
      addToOut("Miesiące: ", dfs.getMonths());
      // skróty miesięcy
      addToOut("Miesiące - skróty: ", dfs.getShortMonths());
      // nazwy dni tygodnia
      addToOut("Dni tygodnia: ", dfs.getWeekdays());
      // skróty nazw dni tygodnia
      addToOut("Dni tygodnia - skróty: ", dfs.getShortWeekdays());
    }
    JTextArea ta = new JTextArea(out);
    ta.setFont(new Font("Dialog", Font.BOLD, 14));
    JFrame f = new JFrame();
    f.getContentPane().add(ta);
    f.pack();
    f.show();
  }

  void addToOut(String msg, String[] s) {
    out += "\n" + msg;
    for (int i=0; i<s.length; i++) {
      out += ' ' + s[i];
    }
  }

  public static void main(String[] args) {
    new DateFormatSymbolsShow();
  }

}

import java.util.*;
import java.text.*;

public class DateFormatPol {

  public static String polskaData(Date data) {
    String[] mies = { "stycznia", "lutego", "marca", "kwietnia",
                      "maja", "czerwca", "lipca", "sierpnia",
                      "września", "października", "listopada",
                      "grudnia"
                    };
    DateFormatSymbols dfs = new DateFormatSymbols();
    dfs.setMonths(mies);
    SimpleDateFormat df = new SimpleDateFormat("dd MMMM yyyy", dfs);
    return df.format(data);
  }



  public static void main(String[] args) {
    System.out.println( polskaData( new Date() ) );
  }

}

Zlokalizowany rozbiór tekstów

Porównywanie i sortowanie napisów

• uzyskać kolator dla lokalizacji domyslnej (polskiej) - metoda Collator.getInstance(),
• podać ten kolator jako komparator w metodzie Arrays.sort(...) 

import java.util.*;
import java.text.*;

public class Kolator0 {

  static void sortShow(String msg, String[] txt, Collator col) {
    String[] copyTxt = (String[]) txt.clone();
    Arrays.sort(copyTxt, col);
    System.out.println(msg);
    for (int i=0; i < copyTxt.length; i++) {
      System.out.println(copyTxt[i]);
    }
  }


  public static void main(String[] args) {
    String[] txt = { "bela", "Ala", "ą", "Ą", "ą", "ala" , "Be", "Ala",
                     "alabama", "be", "Be", "1", "ć", "my", "My", "Myk", "myk"  };
    Collator col = Collator.getInstance();
    sortShow("Sort pol", txt, col);
    Collator col1 = Collator.getInstance(new Locale("en"));
    sortShow("Sort en", txt, col1);
  }

}

• podstawowy (PRIMARY), w którym rozróżniane są (zdefiniowane w zestawie reguł  jako rozróżnialne) znaki,
• drugorzędny (SECONDARY) , który określa porządek napisów identycznych ze względu na porządek podstawowy, ale różniących się akcentowanymi znakami (to dotyczy np. języków francuskiego, hiszpańskiego, angielskiego),
• trzeciorzędny (TERTIARY), który napisy identyczne wedle dwóch poprzednich porządków rozróżnia na podstawie wielkości liter,
• identyczności (IDENTICAL): rozróżniający wszelkie znaki, nawet te uznane za takie same wedle trzech poprzednicj porządków (np. w wielu lokalizacjach znaki \u0001 i \u0002 są uznawane za takie same wedle trzech w/w porządków, natomiast porządek identyczności będzie je rozróżniał)
  

    Collator col = Collator.getInstance();
    String rules = ((RuleBasedCollator) col).getRules();

import java.util.*;
import java.text.*;

public class Kolator1 {

  static void sortShow(String msg, String[] txt, final Collator col) {
    String[] copyTxt = (String[]) txt.clone();
    Arrays.sort(copyTxt, col);
    System.out.println(msg);
    for (int i=0; i < copyTxt.length; i++) {
      System.out.println(copyTxt[i]);
    }
  }


  public static void main(String[] args) {

    // Napisy do posortowania
    String[] txt = { "bela", "Ala", "ą", "Ą", "ą", "ala" , "Be", "Ala",
                     "alabama", "be", "Be", "1", "Ćwikła", "ćwikła",
                     "ćwikla", "Polska",
                     "My", "my", "Myk", "myk"  };

    // Domyślny polski kolator
    Collator col = Collator.getInstance();
    sortShow("Default sort", txt, col);

    // Nowe reguły
    String rules = " < Polska < A < Ą < B < C < Ć < D < E < Ę < F < G < H" +
                  " < I < J < K < L < Ł < M < N < Ń < O < P < Q < R < S < Ś" +
                  " < T < U < V < W < X < Y < Z < Ź " +
                  " < a < ą < b < c < ć < d < e < ę < f < g < h" +
                  " < i < j < k < l < ł < m < n < ń < o < p < q < r < s < ś" +
                  " < t < u < v < w < x < y < z < ź";

    try {
      col = new RuleBasedCollator(rules);
    } catch (ParseException exc) {
        System.out.println("Wadliwa reguła na pozycji " + exc.getErrorOffset());
        System.out.println(exc);
        System.exit(1);
    }

    sortShow("My new rules sort", txt, col);

  }

}

• stworzyć kolekcję lub tablicę na przechowywanie kluczy (obiektów klasy CollationKeys),
• dla każdego napisu, który ma podlegać porządkowaniu (sortowaniu) uzyskąc klucz do kolatora za pomocą wywołania metody getCollationKey(napis) z klasy Collator,
• wstawić klucz do tablicy lub kolekcji,
• posortować tablicę lub kolekcję,
• teraz klucze w tablicy/kolekcji są ustwaione w porządku napisów, określanym przez kolator
• żeby pokazać wynik sortowania przebiegamy tablicę/kolekcję kluczy i od każdgeo klucza za pomocą odwołania getSourceString() uzyskujemy skojarzony z nim napis.

import java.util.*;
import java.text.*;

public class Kolator2 {

  public static void main(String[] args) {

    // Napisy do posortowania
    String[] txt = { "bela", "Ala", "ą", "Ą", "ą", "ala" , "Be", "Ala",
                     "alabama", "be", "Be", "1", "Ćwikła", "ćwikła",
                     "ćwikla", "Polska",
                     "My", "my", "Myk", "myk"  };

    // Domyślny polski kolator
    Collator col = Collator.getInstance();

    // Lista kluczy
    List keys = new ArrayList();

    // Uzyskanie kluczy dla napisów
    // wartości kluczy uzyskujemy od kolatora
    for (int i=0; i<txt.length; i++) {
      CollationKey key = col.getCollationKey( txt[i] );
      keys.add(key);
    }

    // Sortowanie
    // porównywane mogą być tylko klucze uzyskane od tego samego kolatora!

    Collections.sort(keys);

    // Pokazanie wyniku
    // mamy klucze ułożone w określonym porządku napisów, które reprezentują
    // musimy pobrać napis skojarzony z kluczem

    for (Iterator it = keys.iterator(); it.hasNext(); ) {
      CollationKey key = (CollationKey) it.next();
      String napis = key.getSourceString();
      System.out.println(napis);
    }
  }

}

Internacjonalizacja aplikacji i dodatkowe zasoby (resource bundle)

import java.util.*;

public class Hello {

  static void sayHello() {
    Locale defLoc = Locale.getDefault();
    ResourceBundle msgs =
                   ResourceBundle.getBundle("HelloMessages", defLoc);
    String powitaj  = msgs.getString("hello");
    String pozegnaj = msgs.getString("bye");
    System.out.println(powitaj);
    System.out.println(pozegnaj);
 }


  public static void main(String[] args) {
    sayHello(); // tutaj działa domyślna lokalizacja pl_PL
    // zmieniamy domyślną lokalizację
    Locale.setDefault(new Locale("en"));
    sayHello();
  }

}

• pierwsza para napisów powstaje, gdyż domyślną lokalizacją jest pl_PL, getBundle(defLoc) nie znajduje pliku właściwości o takim sufiksie, ale znajduje bliski mu z sufiksem pl, 
• przy drugim odwołaniu do sayHello poszukiwany jest plik HelloMessages_en.properties, a ponieważ go nie ma - używany jest domyślny HelloMessages.properties

• mają nazwy zgodne z opisaną wcześniej (przy okazji plików własciwości) konwencją  (sufiksy wskazujące na lokalizację)
• dziedziczą klasęe ListResourceBundle,
• dostarczają publicznej metody Object[][] getContents() która zwraca tablicę odpowiedniości klucze - wartości, przy czym zaróno klucze jak i odpowiadające im wartości mogą być dowolnymi obiektami.

public class CountryInfo_pl_PL extends ListResourceBundle {

   public Object[][] getContents() {
	return contents;
    }

    private Object[][] contents = {
	{ "name", "Polska" },
	{ "flag",  new ImageIcon("PolskaFlaga.gif" },
    };
}

ResourceBundle info =
		ResourceBundle.getBundle("CountryInfo", currentLocale);

String nazwaKraju = info.getString("name");
ImageIcon flaga = (ImageIcon) info.getObject("flag");