24.5. Formatering af datoer og klokkeslæt

24.5.1. Prædefineret formater

Klassen DateFormat indeholder en række statiske fabriksmetoder, som returner specialiseret formateringsobjekter. Seks af disse er

getDateInstance(int style)
getDateInstance(int style, Locale aLocale)
getTimeInstance(int style)
getTimeInstance(int style, Locale aLocale)
getDateTimeInstance(int dateStyle, int timeStyle)
getDateTimeInstance(int dateStyle, int timeStyle, Locale aLocale)

Metoderne tager imod en eller flere style-parametre, som anvendes til at angive længden af formateringsresultatet. De mulige værdier er defineret som konstanter i DateFormat-klassen.

• SHORT forsøger at være numerisk og kort, f.eks. 12/11/01 og 2:31 AM

• MEDIUM er længere, f.eks. Dec 11, 2001 og 2:31:35 AM

• LONG er endnu længere, f.eks. December 11, 2001 og 2:31:35 AM CET

• FULL er fuldstændig specificeret, f.eks. Tuesday, December 11, 2001 og 2:31:35 AM CET

• DEFAULT svarer til DateFormat.MEDIUM.

Det præcise resultat afhænger af lokalindstillingen. Hvis vi i det ovenstående havde brugt en dansk lokalindstilling så ville der ikke være nogen synlig forskel på brugen af LONG og FULL.

Her er et simpelt eksempel, der viser brugen af DateFormat med den globale lokalindstilling.

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

public class DateFormatExample
{
  public static void main(String arg[])
  {
    DateFormat klformat, datoformat, dkf;
    klformat   = DateFormat.getTimeInstance(DateFormat.MEDIUM);
    datoformat = DateFormat.getDateInstance(DateFormat.FULL);
    dkf = DateFormat.getDateTimeInstance(DateFormat.MEDIUM, DateFormat.SHORT);

    Date tid = new Date();
    System.out.println( tid );
    System.out.println( "Kl   :"+ klformat.format(tid) );
    System.out.println( "Dato :"+ datoformat.format(tid) );
    System.out.println( "Tid  :"+ dkf.format(tid) );
  }
}

Kørsel af ovenstående program med dansk lokalindstilling (da_DK) giver

Mon Dec 03 13:28:06 GMT+01:00 2001
Kl:   13:28:06
Dato: 3. december 2001
Tid:  03-12-2001 13:28

Hvis lokalindstillingen er amerikansk (en_US) så fås imidlertid

Mon Dec 03 13:27:57 GMT+01:00 2001
Kl:   1:27:57 PM
Dato: Monday, December 3, 2001
Tid:  Dec 3, 2001 1:27 PM

Læg i øvrigt mærke til at Date-objektets toString()-metode ikke er lokaliseret. Den bør kun bruges til testudskrifter og logning, og ikke i tekst som brugeren skal læse (med mindre du bevidst ønsker at irritere ham/hende).

24.5.2. Egne formater

Ønsker man som programmør større kontrol over hvordan datoen bliver formateret så må man selv specificere formatet med SimpleDateFormat.

Lad os starte ud med et eksempel.

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

public class BenytSimpleDateFormat
{
  public static void main(String arg[])
  {
     DateFormat df = new SimpleDateFormat("EEEE 'den' d. MMMM 'år' yyyy.");

     Date tid = new Date();
     System.out.println( df.format(tid) );
  }
}

Kørsel af ovenstående program med dansk lokalindstilling giver

mandag den 10. december år 2001.

En tilsvarende kørsel af programmet med amerikansk lokalindstilling giver

Monday den 10. December ?r 2001.

Ud fra eksemplet ses at formateringsresultatet afhænger af to faktorer: lokalindstillingen samt argumentet angivet til SimpleDateFormats konstruktør. Argumentet angiver et mønster, som angiver hvordan dato- og klokkeslætformateringen logisk bør tage sig ud. Dato- og klokkeslætformater specificeres ved hjælp af bogstaverne a-z og A-Z som har en speciel betydning så længe de ikke er omgivet af apostroffer. F.eks. dækker M over måneden i et år, mens E dækker over dagen i en uge. Antallet af gange et bogstav gentages er ikke helt uden betydning. Gentages M fire gange som i eksemplet så skrives måneden som en tekst, f.eks. 'december', men vises den kun en gang så skrives måneden som et tal, f.eks. 12. Bemærk at konstanterne SHORT, MEDIUM, LONG og FULL i DateFormat-klassen afspejler dette.

I skrivende stund er det ikke alle bogstaver, der har fået tillagt en betydning. Nedenstående tabel viser dem som findes i JDK 1.4. En lignende tabel findes også i API-dokumentationen for SimpleDateFormat.

Ugedagen i en måned kræver en kort forklaring. Hvis datoen er tirsdag den 11. maj 2002, så fortæller den os at det er den 2. tirsdag i maj måned 2002. Er datoen derimod lørdag den 15. maj 2002 så fortæller den os at det er den 3. lørdag i maj måned.