日付/時刻形式の構文

アダプタは、Java の単純なデフォルトの日付および時刻形式構文 (米国ロケール) を使用します。これらの形式を名前パターンに指定するには、時刻パターン文字列を使用します。

---

注 –

アダプタは、Java クラス java.text.SimpleDateFormat の Java 標準日付/タイムスタンプを使用します。これらの形式の一部は、使用中の Java SDK バージョンによっては、次に示すリストと異なることがあります。

---

これらのパターンでは、すべての ASCII 文字はパターン文字として予約されています。完全なリストについては、表 1–2 を参照してください。

表 1–2 時刻パターン文字列と意味

シンボル	意味	表現	例
%G	年号指示子	テキスト	AD
%y	年	数	1996
%M	月 (年)	テキストおよび数	July & 07
%d	日 (月)	数	10
%h	時間 (午前/午後) (1 - 12)	数	12
%H	時 (日) (0 - 23)	数	0
%m	分 (時)	数	30
%s	秒 (分)	数	55
%S	ミリ秒	数	978
%E	曜日 (週)	テキスト	火曜日
%D	日 (年)	数	189
%F	曜日 (月)	数	2 (7 月の第 2 水曜日)
%w	週 (年)	数	27
%W	週 (月)	数	2
%a	午前/午後記号	テキスト	PM
%k	時間 (日) (1 - 24)	数	24
%K	時間 (午前/午後) (0 - 11)	数	0
%z	タイムゾーン	テキスト	太平洋標準時

日付/時刻形式の全般的なルールは、次のとおりです。

• テキスト: パターン文字の数によって、形式が次のように決まります。

  • 4 つ以上のパターン文字の場合、完全な形式を使用します。

  • 4 文字未満の場合、存在する場合は短い形式 (省略形) を使用します。

  数: 最小桁数は次のように扱われます。

  • 少ない数はその桁数まで 0 で埋められます。

  • 年の処理は異なります。「y」の数が 2 の場合、年は 2 桁に切り捨てられます。

  テキストおよび数: 3 つ以上のパターン文字の場合、テキストを使用します。それ以外は、数を使用します。

• 引用符と区切り文字: これらのシンボルは、次のように使用します。

  • 表示するリテラルテキストを一重引用府で囲みます。

  • 一重引用府を意味するには、二重引用符を使用します。

  • 区切り文字にコンマを使用します。

    表 1–3 は、米国ロケールを使用したいくつかの例を示しています。

表 1–3 米国ロケールの日付/時刻パターン

形式パターン	結果
yyyy.MM.dd, G, ’at’ hh:mm:ss, z	1996.07.10 AD at 15:08:56 PDT
E, M, dd, ’’yy	Wednesday, July 10, ’96
h:mm, a	12:08 PM
h, ’o’’clock’ a, z	12 o’clock PM., Pacific Daylight Time
K:mm a, z	0:00 p.m., PST
yyyyy.M.dd, G, hh:mm, a	1996.July.10 AD 12:08 PM