JSTLを使って日付データを加工する：JavaTips 〜JSP／サーブレット編

　「JSTLを使って数値データを加工する」では、JSTLのi18nタグライブラリを利用することで数値データをさまざまなパターンに整形する方法について紹介しました。本TIPSでは、同じくi18nタグライブラリを利用して、日付データを加工する方法について紹介することにしましょう。

　日付データには、数値データ以上に表記のパターン（和暦／西暦、YYYY年MM月DD日、YYYY/MM/DD、YY-MM-DDなど）が存在しますし、国／地域によっても表記ルールが異なる場合があります。Java基本APIには、こうした日付の整形を行うための専用のjava.text.SimpleDateFormatクラスが用意されていますが、日付を整形するだけのための定型的な操作に、いちいちスクリプトレットを記述しなければならないのは面倒です。しかし、<fmt:formatDate>要素を利用することで、必要なパラメータを属性値として指定するだけでスクリプトレスに日付加工を実現することができます。以下に、<fmt:formatDate>要素を利用した簡単な用例を見てみることにしましょう。

<%@ page contentType="text/html;charset=Windows-31J" %>
<%@ taglib prefix="fmt" uri="http://java.sun.com/jsp/jstl/fmt" %>
<jsp:useBean id="today" class="java.util.Date" />
<fmt:formatDate value="${today}" type="DATE" dateStyle="FULL" />

　<fmt:formatDate>要素は、value属性で指定された値を、その他属性で指定された様式に従って加工し、結果を出力します（注）。上の例の場合、type属性がDATE（日付）なので日付部分のみを、dateStyle属性がFULLなので一番長い形式で、出力します。つまり、上の用例は結果として以下のような出力を生成します。

2004年12月11日

　そのほかにも、<fmt:formatDate>要素にはさまざまな属性が用意されています。以下に主要な属性をまとめておくことにしましょう。

　type属性によって、表示対象を日付のみ、時刻のみ、日付・時刻双方のいずれかから選択することができます。dateStyle、timeStyle属性は、日付・時刻部分それぞれについて、どのようなスタイル形式で表示するかを選択します。一般的には、これら属性の指定だけでも大部分の用途を賄うことができるはずですが、時として、より複雑な書式を指定したいというケースがあるかもしれません。そのような場合には、pattern属性でカスタムの書式文字列を指定することも可能です。例えば、以下のような使い方をします。

<fmt:formatDate value="${today}" type="DATE"
pattern="yyyy年MM月dd日（E） a KK時mm分ss秒" />

　この書式文字列の結果は以下のとおりです。

2004年12月11日（土） 午後 00時21分35秒

　上記はほんの一例ですが、pattern属性では以下のような書式記述子を組み合わせることで、さまざまなパターンを表現することができます。最後に、pattern属性で利用可能なパターン記述子を挙げておくことにしましょう。