Name: ssT124754 Date: 03/19/2001


java version "1.3.0_02"
Java(TM) 2 Runtime Environment, Standard Edition (build 1.3.0_02)
Java HotSpot(TM) Client VM (build 1.3.0_02, mixed mode)


http://java.sun.com/products/jdk/1.2/docs/api/index.html
http://java.sun.com/products/jdk/1.3/docs/api/index.html
The documentation for 'DateFormat' says about the style:

SHORT is completely numeric, such as 12.13.52 or 3:30pm
MEDIUM is longer, such as Jan 12, 1952
LONG is longer, such as January 12, 1952 or 3:30:32pm
FULL is pretty completely specified, such as Tuesday, April 12, 1952 AD or
3:30:42pm PST

But this sample program

import java.util.*;
import java.text.DateFormat;
 
public class Test {
  public static void main( String[] asParam ) {
    Locale.setDefault( new Locale( "en", "US" ) );
    Date date = new Date( 0 );
    System.out.println( DateFormat.getDateTimeInstance(
      DateFormat.SHORT, DateFormat.SHORT ).format( date )
    );
    System.out.println( DateFormat.getDateTimeInstance(
      DateFormat.MEDIUM, DateFormat.MEDIUM ).format( date )
    );
    System.out.println( DateFormat.getDateTimeInstance(
      DateFormat.LONG, DateFormat.LONG ).format( date )
    );
    System.out.println( DateFormat.getDateTimeInstance(
      DateFormat.FULL, DateFormat.FULL ).format( date )
    );
  }
}

gives

1/1/70 1:00 AM
Jan 1, 1970 1:00:00 AM
January 1, 1970 1:00:00 AM CET
Thursday, January 1, 1970 1:00:00 AM CET

So

1. The time-format for MEDIUM is missing
2. The time-format for LONG is incorrect
3. The AM/PM is in upper case and seperated with a blank
4. The year misses the AD

I suggest updating the documentation.

Ofcourse the documentation says that the results are locale dependant.I feel the docs should atleast mention the locale for which the results in docs match. Otherwise it is misleading the user.


(Review ID: 119018)
======================================================================