【Java入門】SimpleDateFormatで日付フォーマットの設定

Javaには日付を表示するときのフォーマットを設定することができます。この記事では、日付のフォーマットについて、

【基礎】SimpleDateFormatクラスの日付のフォーマットとは
【基礎】yyyy/MM/ddのフォーマットを設定する方法
【基礎】他の日付のフォーマットに変更する方法
【発展】日付をString型に変換する方法
【発展】日付パターンをチェックする方法

などの基礎から発展した使い方についても解説していきます。今回はそんな日付のフォーマット処理について、さまざまな方法をわかりやすく解説します！

なお、Javaの記事については、こちらにまとめています。

この記事の目次

1 SimpleDateFormatクラスの日付パターンとは
2 Date型とString型の相互変換
3 日付パターンをチェックする方法
4 Date型についてもっと詳しく知りたい方へ
5 まとめ

SimpleDateFormatクラスの日付パターンとは

日付のフォーマットを設定するには、SimpleDateFormatクラスを使用して、インスタンスの引数に日付フォーマットを指定する必要があります。

SimpleDateFormat sdf = new SimpleDateFormat(“フォーマットパターン”);

SimpleDateFormatクラスを使用するには、以下のパッケージをインポートします。

import java.text.SimpleDateFormat;

日付パターン文字列について表にまとめました。

文字	説明	出力例(記述例)
G	紀元	AD(G)
y	年	1996(yyyy); 96(yy)
M	月	July(MMMM); Jul(MM); 07(MM)
w	年における週	27(ww)
W	月における週	2(W)
D	年における日	189(DDD)
d	月における日	10(dd)
F	月における曜日	2(F)
E	曜日の名前	Tuesday(EEEEEEE); Tue(EEE);
u	曜日の番号(1:月曜、・・・7:日曜)	1(u)
a	午前/午後	PM(a)
H	一日における時(0 - 23)	00(HH)
k	一日における時(1 - 24)	24(kk)
K	午前/午後の時(0 - 11)	00(KK)
h	午前/午後の時(1 - 12)	12(hh)
m	分	30(mm)
s	秒	55(ss)
S	ミリ秒	978(SSS)
z	一般的なタイムゾーン	Pacific Standard Time; PST; GMT-08:00

記述するパターン例については以下のとおりです。

パターン	表示例
"yyyy.MM.dd G 'at' HH:mm:ss z"	2001.07.04 AD at 12:08:56 PDT
"EEE, MMM d, ‘’yy”	Wed, Jul 4, '01
"h:mm a"	12:08 PM

日付パターンは、大文字と小文字が明確に区別されていますので、指定時には注意しましょう。なおオラクルの公式サイトには、日付パターンの詳細が記載されています。
https://docs.oracle.com/javase/jp/8/docs/api/java/text/SimpleDateFormat.html

yyyy/MM/ddのフォーマットで設定する方法

以下に“yyyy/MM/dd”の日付パターンでフォーマットを設定する方法を記述します。

import java.util.Calendar;
import java.text.SimpleDateFormat;

public class Main {
 
    public static void main(String[] args) {
        //Calendarクラスのオブジェクトを生成する
        Calendar cl = Calendar.getInstance();
        
        //SimpleDateFormatクラスでフォーマットパターンを設定する
        SimpleDateFormat sdf = new SimpleDateFormat("yyyy/MM/dd");
        System.out.println(sdf.format(cl.getTime()));
    }

}

実行結果：

2017/04/06

このサンプルコードでは、SimpleDateFormatクラスを使用して、引数に“yyyy/MM/dd”の日付パターンでフォーマットを指定しています。

そして、SimpleDateFormatクラスの日付パターンを返すformatメソッドを使用しています。引数にはCalendarクラスのgetTimeメソッドを指定して現在の日時を取得しています。

他の日付フォーマットに変更する方法

日付のフォーマットを変更する場合は、SimpleDateFormatクラスのapplyPatternメソッドを使用します。そしてSimpleDateFormatクラスのインスタンス同様、引数にフォーマットパターンを指定します。

以下に日付フォーマットを変更する方法を記述します。

import java.util.Calendar;
import java.text.SimpleDateFormat;

public class Main {
 
    public static void main(String[] args) {
        //カレンダークラスのオブジェクトを生成する
        Calendar cl = Calendar.getInstance();
        
        //フォーマットを指定する
        SimpleDateFormat sdf = new SimpleDateFormat("変更前：yyyy/MM/dd");
        System.out.println(sdf.format(cl.getTime()));
        
        //フォーマットをフォーマットを変更する
        sdf.applyPattern("変更後：yyyy年MM月dd日 E");
        System.out.println(sdf.format(cl.getTime()));
    }

}

実行結果：

変更前：2017/04/06
変更後：2017年04月06日 Thu

Calendarクラスのフォーマットについては、以下の記事でも詳しく解説しています！

【Java入門】Calendarの日付フォーマットを指定する(format)

更新日：2023年3月21日

【なかなかエラーが解決できない…そんな悩みを解決します！】

登録無料で始められるプログラミングスクール「侍テラコヤ」

・回答率100%のQ&A掲示板でエラーを解決！
・現役エンジニアとのオンライン相談で悩みを解決！
・50種類以上の教材で複数言語を習得！

⇒ 侍テラコヤについて詳しく見る

Date型とString型の相互変換

Date型で処理をしてString型に変換したり、また逆にString型の日付データからDate型に変更して処理を行う場合もあります。Date型をString型に変換する方法やString型をDate型に変更する方法についてみていきましょう！

Date型をString型に変換する

Date型をString型に変換するためには、StringクラスのvalueOfメソッドを指定して、引数に日付型を指定します。

String.valueOf(date型);

以下にDate型をString型に変換する方法を記述します。

import java.util.Date;

public class Main {
 
    public static void main(String[] args) {
        Date date = new Date();
        
        String str = String.valueOf(date);
        System.out.println(str);
    }

}

実行結果：

Thu Apr 06 09:59:22 UTC 2017

String型をDate型に変換する

String型の日付をDate型に変換するには、SimpleDateFormatクラスのparseメソッドを使用します。

SimpleDateFormat.parse(String型);

import java.util.Date;
import java.text.ParseException;
import java.text.SimpleDateFormat;

public class Main {
 
    public static void main(String[] args) {
        String str = "20170401 12:00:00";
        
        SimpleDateFormat sdf = new SimpleDateFormat("yyyyMMdd HH:mm:ss");
        try {
            Date date = sdf.parse(str);
            System.out.println(date.toString());
        } catch(ParseException e) {
            e.printStackTrace();
        }           
    }

}

実行結果：

Sat Apr 01 12:00:00 UTC 2017

SimpleDateFormatクラスのparseメソッドを使うにはthrows句を使ってParseExceptionなどに例外を投げるか、try-catch構文で例外処理を行う必要がありますので注意しましょう。なおStringのさまざまな型変換については、以下の記事で詳しく解説しています！

JavaでString（文字列）を変換する方法まとめ（short,int,long等に変換）

更新日：2023年3月21日

日付パターンをチェックする方法

SimpleDateFormatクラスは、日付パターンを存在しないパターンなどに設定するとIllegalArgumentExceptionの例外が発生します。しかし、日付設定時に存在しない日付を設定しても例外は発生しません。

そのため、設定した日付が正しいかチェックするには、日付を設定する前にSimpleDateFormatクラスのsetLenientメソッドを使用します。setLenientメソッドの引数にはfalseを設定する必要があります。

SimpleDateFormat.setLenient(false);

以下に設定した日付をチェックする方法を記述します。

import java.text.ParseException;
import java.text.SimpleDateFormat;

public class Main {
 
    public static void main(String[] args) {
        SimpleDateFormat sdf = new SimpleDateFormat("yyyy/MM/dd");
        sdf.setLenient(false);
        
        try{
            sdf.parse("2017/4/35");
            System.out.println("正しい日付です");
        } catch (ParseException e){
            System.out.println("正しい日付ではありません");
        }
    }

}

実行結果：