SimpleDateFormatクラス

SimpleDateFormatクラスはDateFormatクラスの実装クラスで、より細かいフォーマット方法を指定できます。

まず下記のクラス図を見てください。

java.lang.Object
  java.text.Format
    java.text.DateFormat
      java.text.SimpleDateFormat

public class SimpleDateFormat extends DateFormat

コンストラクタは4つ用意されています。

コンストラクタ
SimpleDateFormat() デフォルトロケールのデフォルトパターンと日付フォーマット記号を使って SimpleDateFormat を構築します。
SimpleDateFormat(String pattern) 指定されたパターンとデフォルトロケールのデフォルト日付フォーマット記号を使って SimpleDateFormat を構築します。
SimpleDateFormat(String pattern, DateFormatSymbols formatSymbols) 指定されたパターンと日付フォーマット記号を使って SimpleDateFormat を構築します。
SimpleDateFormat(String pattern, Locale locale) 指定されたパターンと指定されたロケールのデフォルト日付フォーマット記号を使って SimpleDateFormat を構築します。

コンストラクタではパターンを指定します。2番目のコンストラクタを見てみます。

public SimpleDateFormat(String pattern)

指定されたパターンとデフォルトロケールのデフォルト日付フォーマット記号
を使って SimpleDateFormat を構築します。注: このコンストラクタはすべて
のロケールをサポートするわけではありません。すべてをカバーするには、
DateFormat クラスのファクトリメソッドを使用してください。 

パラメータ:
  pattern - 日付と時刻のフォーマットを記述するパターン 
例外: 
  NullPointerException - 指定されたパターンが null の場合 
  IllegalArgumentException - 指定されたパターンが正しくない場合

パターンの具体的な記述方法ですが、下記の規則に従って記述します。

文字	日付または時刻のコンポーネント	表示	例
G	紀元	テキスト	AD
y	年	年	1996; 96
M	月	月	July; Jul; 07
w	年における週	数値	27
W	月における週	数値	2
D	年における日	数値	189
d	月における日	数値	10
F	月における曜日	数値	2
E	曜日	テキスト	Tuesday; Tue
a	午前/午後	テキスト	PM
H	1日における時 (0 ～ 23)	数値	0
k	1日における時 (1 ～ 24)	数値	24
K	午前/午後の時 (0 ～ 11)	数値	0
h	午前/午後の時 (1 ～ 12)	数値	12
m	分	数値	30
s	秒	数値	55
S	ミリ秒	数値	978
z	タイムゾーン	一般的なタイムゾーン	Pacific Standard Time; PST; GMT-08:00
Z	タイムゾーン	RFC 822 タイムゾーン	-0800

上記で書かれている"文字"の組み合わせで指定します。それぞれの文字は何個繰り返し使うかで表示方法が異なってきます。実際の使い方とパターン毎の結果については例えば下記のようになります。

SimpleDateFormat sdf1 = new SimpleDateFormat("y.M");
System.out.println(sdf1.format(new Date()));

ここで使ってるformatメソッドは親クラスのDateFormatクラスで用意されているformatメソッドを使っています。

上記のように何回繰り返し指定するかで結果は変わってきます。また先ほどの一覧表の"表示"というところに書かれている"テキスト"、"年"、"月"、"数値"の種類によって、繰り返した回数をどう処理するかが変わってきます。1つ1つ見ていきます。

テキスト

テキストは次のように書かれています。「パターン文字の数が 4 以上の場合、フォーマットにはフル形式を使用します。そうでない場合、短い形式または省略された形式があれば、それを使用します」。

実際にテキストタイプのG(紀元)、E(曜日)、a(午前/午後)について試した結果を下記に記載します。

紀元と午前/午後については省略形が無いようでどのパターンでも同じでした。曜日については4以上でフル形式、3以下の場合で省略形が表示されました。

年

年については次のように書かれています。「パターン文字の数が 2 の場合、フォーマットには年が 2 桁に短縮されます。そうでない場合は、数値として解釈されます」。

上記はLocale.USの場合も同様でした。パターンが3の場合は"005"になるかと思いましたが、年には2桁か4桁かしかないかと思います。4桁の場合はパターンが5以上の場合は頭に0が付くようです。

月

月については次のように書かれています。「パターン文字の数が 3 以上の場合、フォーマットには月がテキストとして解釈されます。そうでない場合は、数値として解釈されます」。

パターンが1及び2の場合は数字として、3以上の場合は、3の場合は数字部分だけ、4以上の場合はフル形式で表示されているかと思います。ちなみに12月に時間を進めて試していみると下記のようになりました。

数値

数値については次のように書かれています。「フォーマットには、パターン文字の数は最小桁数になります。これより短い数値は、この桁数までゼロが追加されます」。

パターン数が数字を表示するのに足りない場合は、数字を全部表示し、パターン数が数字よりも多い場合には0で埋められるようです。Local.USの場合も同じ結果となりました。

タイムゾーン

タイムゾーンについてはよく分かっていないのですが、実際に試した結果を下記に記述します。

パターンの中に文字を入れる場合

'A' ～ 'Z' および 'a' ～ 'z' は全て予約済みとなっており、これらの文字を文字列としてパターンの中に入れたい場合は単一引用符 (') で囲んで入れることができます。例えば下記のようになります。

上記では"at"という文字を表示させています。実際の実行結果は下記のようになります。

単一引用符そのものを表示させたい場合は、「''」のように記述します。

メソッドでのパターン指定

パターンはコンストラクタで指定する以外にapplyPatternメソッドでも指定が可能です。

実際の使い方

SimpleDateFormatは直接インスタンスを作成することもできますが、DateFormatクラスのgetDateTimeInstanceメソッドを使った作成したインスタンスをSimpleDateFormatクラスにキャストして使った方がいいようなことが記載されています。できればファクトリメソッドを使えということでしょう。