JavaのSimpleDateFormatで使えるフォーマットパターン文字の一覧と使い方

java.text.SimpleDateFormatクラスは、文字列を日付（Date）に変換したり、日付を指定した形式の文字列に整形したりするために使用されるクラスです。本記事では、SimpleDateFormatで利用できるフォーマットパターン文字の一覧と、実際のコード例をわかりやすく解説します。

日付文字列の解析（パース）方法

SimpleDateFormatクラスのコンストラクタの一つは、目的の日付フォーマットを表すString型の値を受け取り、SimpleDateFormatオブジェクトを生成します。文字列をDateオブジェクトとして解析・変換する手順は以下の通りです。

• 希望するフォーマット文字列を引数に渡して、SimpleDateFormatクラスをインスタンス化します。
• parse()メソッドを使って、日付文字列を解析します。

以下は、日付のフォーマットに使用できる文字（パターン文字）とその意味、出力例の一覧です。

コード例：日付文字列の解析

import java.text.ParseException;
import java.text.SimpleDateFormat;
import java.util.Date;
public class Sample {
    public static void main(String args[]) throws ParseException { 
        SimpleDateFormat formatter = new SimpleDateFormat("yyyy/dd/MM");          
        Date date = formatter.parse("2007/25/06");
        System.out.println("Date value: "+date);         
        formatter = new SimpleDateFormat("y:G");          
        date = formatter.parse("1920:BC");
        System.out.println("Date value: "+date);         
        formatter = new SimpleDateFormat("D-M-Y");          
        date = formatter.parse("25-05-1989");
        System.out.println("Date value: "+date);
    }
}

実行結果

Date value: Mon Jun 25 00:00:00 IST 2007
Date value: Sun Jan 01 00:00:00 IST 1920
Date value: Sun Jan 01 00:00:00 IST 1989

上記の例では、「yyyy/dd/MM」のように複数のパターン文字を組み合わせることで、任意の形式の日付文字列を解析できます。「y:G」は年と紀元、「D-M-Y」は年間通算日・月・週基準年の組み合わせです。

コード例：時刻や曜日を含む解析

import java.text.ParseException;
import java.text.SimpleDateFormat;
import java.util.Date;
public class Sample {
    public static void main(String args[]) throws ParseException { 
        SimpleDateFormat formatter1 = new SimpleDateFormat("HH:mm:ss");          
        Date time1 = formatter1.parse("07:25:30");
        System.out.println("Date value: "+time1);         
        SimpleDateFormat formatter2 = new SimpleDateFormat("EEE:MMM-d:YYYY");          
        Date time2 = formatter2.parse("Sun:Jan-8:2018");
        System.out.println("Date value: "+time2);         
        SimpleDateFormat formatter3 = new SimpleDateFormat("hh 'o''clock' a");          
        Date time3 = formatter3.parse("09 o'clock AM");
        System.out.println("Date value: "+time3);
    }
}

実行結果

Date value: Thu Jan 01 07:25:30 IST 1970
Date value: Sun Dec 31 00:00:00 IST 2017
Date value: Thu Jan 01 09:00:00 IST 1970

3つ目の例のように、シングルクォート（'）で囲んだテキストはリテラル（固定文字列）として扱われます。これにより「o'clock」のような文字を含む独自フォーマットも解析可能になります。

なお、SimpleDateFormatはスレッドセーフではないため、マルチスレッド環境では注意が必要です。Java 8以降を使用している場合は、より安全で機能豊富なjava.time.format.DateTimeFormatterの利用も検討するとよいでしょう。