JavaのSimpleDateFormatクラスとは？文字列と日付の相互変換を徹底解説

java.text.SimpleDateFormatクラスは、文字列を日付（Dateオブジェクト）に変換する「解析（パース）」や、日付を指定した書式の文字列に整える「フォーマット」を行うために使用されるクラスです。

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

このクラスのコンストラクタの一つは、希望する日付書式を表す文字列を受け取り、SimpleDateFormatオブジェクトを生成します。文字列をDateオブジェクトとして解析・変換するには、以下の手順に従います。

• 目的の書式パターン文字列を引数に渡して、SimpleDateFormatクラスをインスタンス化する。
• parse()メソッドを使用して、日付文字列を解析し、Dateオブジェクトとして取得する。

サンプルコード

import java.text.ParseException;
import java.text.SimpleDateFormat;
import java.util.Date;
public class Sample {
    public static void main(String args[]) throws ParseException {
        String date_string = "2007-25-06";
        // SimpleDateFormatクラスのインスタンス化
        SimpleDateFormat formatter = new SimpleDateFormat("yyyy-dd-MM");
        // 指定した文字列をDateオブジェクトへ変換
        Date date = formatter.parse(date_string);
        System.out.println("Date value: "+date);
    }
}

実行結果

Date value: Mon Jun 25 00:00:00 IST 2007

主な書式パターンの意味

コンストラクタに渡すパターン文字列は、以下のような記号で構成されます。

• yyyy … 西暦年（4桁）
• MM … 月（2桁）
• dd … 日（2桁）
• HH:mm:ss … 時・分・秒

上記の例では「yyyy-dd-MM」と指定しているため、「2007-25-06」は「2007年6月25日」として正しく解析されます。

現在の書式パターン文字列を取得する

このクラスが持つtoPattern()メソッドは、現在のオブジェクトの書式を表すパターン文字列を返します。

サンプルコード

import java.text.ParseException;
import java.text.SimpleDateFormat;
public class Demo {
    public static void main(String args[]) throws ParseException {
        SimpleDateFormat obj = new SimpleDateFormat();
        String pattern = obj.toPattern();
        System.out.println(pattern);
    }
}

実行結果

M/d/yy h:mm a

引数なしでインスタンス化した場合、実行環境のロケール（地域設定）に応じたデフォルトのパターンが適用されます。

テキストの中から日付部分だけを解析する

parse()メソッドは、日付文字列に加えてParsePositionオブジェクトを引数として受け取ることもできます。これにより、長いテキストの中から指定位置以降の日付部分だけを抜き出して解析できます。

サンプルコード

import java.text.ParseException;
import java.text.ParsePosition;
import java.text.SimpleDateFormat;
import java.util.Date;
public class Sample {
    public static void main(String args[]) throws ParseException {
        String text = "Marriage date of Samrat is 2007-25-06";
        // SimpleDateFormatクラスのインスタンス化
        SimpleDateFormat formatter = new SimpleDateFormat("yyyy-dd-MM");
        // テキスト内の27文字目から日付を解析
        ParsePosition pos = new ParsePosition(27);
        Date date = formatter.parse(text, pos);
        System.out.println("Date value: "+date);
    }
}

実行結果

Date value: Mon Jun 25 00:00:00 IST 2007

このようにParsePositionで開始位置を指定することで、文章中に埋め込まれた日付情報も柔軟に取り出せます。