日時を表示したり、特定の書式に変換します。この動作を応用して、日時から日にちや時間のみを抽出できます。
タグで囲んだ内容をformat
属性の日時書式に従い変換します。また、タグで囲んだ内容が無い場合はシステム日時を利用します。
1 2 3 4 5 6 |
<category> <pattern>*</pattern> <template> <date/> <!-- システム日時をデフォルトの書式で出力します。 --> </template> </category> |
属性
名称 | 型 | 必須 | デフォルト | 説明 |
---|---|---|---|---|
format |
日時書式 | – | yyyy-MM-dd'T'HH:mm:ss |
出力する日時書式を指定します。 |
parse_format |
日時書式 | – | yyyy-MM-dd'T'HH:mm:ss |
タグで囲んだ内容を解析する際の日時書式を指定します。 |
format
この属性は出力する際の日時書式を指定します。
また、日時書式はjava.time.format.DateTimeFormatter
に準拠した内容を指定してください。
Example
1 2 3 4 5 6 7 |
<category> <pattern>*</pattern> <template> <!-- システム日時を「2019/02/14」の形式で出力します。 --> <date format="yyyy/MM/dd" /> </template> </category> |
parse_format
この属性はタグで囲んだ内容を日時表現として解析する際の日時書式を指定します。
また、日時書式はjava.time.format.DateTimeFormatter
に準拠した内容を指定してください。
Example
1 2 3 4 5 6 7 |
<category> <pattern>*</pattern> <template> <!-- 「2019年02月14日」を「2019/02/14」に書式を変更して出力します。 --> <date format="yyyy/MM/dd" parse_format="yyyy年MM月dd日">2019年02月14日</date> </template> </category> |
日時書式の記述例
<date>
タグではformat
属性、parse_format
属性に日時書式を指定することで下記表のように、様々な日時書式の文字列を扱うことができます。
日時表現 | <date> タグ記述例 |
出力文字列 |
---|---|---|
現在日時出力 | <date/> |
2017-10-04T15:28:53 |
<date format="yyyy/MM/dd HH:mm:ss"/> |
2017/10/04 15:28:53 |
|
<date format="yyyy年MM月dd日 HH時mm分ss秒"/> |
2017/年10月04日 15時28分53秒 |
|
英語日時表現 | <date parse_format="yyyy-MM-dd">2011-12-03</date> |
2011-12-03T00:00:00 |
<date parse_format="HH:mm:ss">10:15:30</date> |
1970-01-01T10:15:30 |
|
<date parse_format="d MMM yyyy HH:mm:ss">3 Jun 2008 11:05:30</date> |
2008-06-03T11:05:30 |
|
<date parse_format="d MMM yyyy HH:mm">3 Jun 2008 11:05</date> |
2008-06-03T11:05:00 |
|
<date parse_format="yyyyMMdd">20111203</date> |
2011-12-03T00:00:00 |
|
<date parse_format="yyyy-MM-dd">2011-12-03</date> |
2011-12-03T00:00:00 |
|
<date>2011-12-03T10:15:30</date> |
2011-12-03T10:15:30 |
|
<date>2011-12-03T10:15:30Z</date> |
2011-12-03T10:15:30 |
|
<date parse_format="EEE, d MMM yyyy HH:mm:ss">Tue, 3 Jun 2008 11:05:30</date> |
2008-06-03T11:05:30 |
|
日本語日時表現 | <date parse_format="yyyy年MM月dd日">2011年12月03日</date> |
2011-12-03T00:00:00 |
<date parse_format="HH時mm分ss秒">10時15分30秒</date> |
1970-01-01-T10:15:30 |
|
<date parse_format="yyyy年MM月dd日HH時mm分ss秒">2011年12月03日10時15分30秒</date> |
2011-12-03T10:15:30 |
子要素
<template>
タグと同様です。