Tstamp

説明

現在プロジェクトの DSTAMP、TSTAMP、および TODAY プロパティを設定します。デフォルトでは、DSTAMP プロパティは yyyyMMdd フォーマット、TSTAMP は hhmm フォーマット、TODAY は MMMM dd yyyy フォーマットです。ネストされた <format> 要素を使用して別のフォーマットを指定します。

これらのプロパティはビルドファイル内で、タイムスタンプ付きのファイル名を作成したり、ドキュメント内のプレースホルダータグを置き換えてリリース日などを示すために使用できます。このタスクは、おそらく初期化ターゲットでの使用に適しています。

Ant 1.10.2 以降 再現可能ビルドを作成するために、固定された日付値を指定するにはマジックプロパティ ant.tstamp.now を使用できます。その値は数値でなければならず、エポック（1970 年 1 月 1 日午前 0 時）からの秒数として解釈されます。ant.tstamp.now.iso を使用すると、その値を ISO-8601 形式（1972-04-17T08:07:00Z）で指定できます。無効な形式で値を指定すると、INFO メッセージがログに記録され、その値は無視されます。

Ant 1.10.8 以降 SOURCE_DATE_EPOCH 環境変数の値（設定されている場合）は、再現可能ビルドに対して尊重されます。その環境変数に無効な値（整数にパースできない値）が指定されている場合、Ant は DEBUG メッセージをログに記録し、代わりに「現在の」日付を使用します。

パラメーター

属性 説明 必須
prefix 設定されているすべてのプロパティに使用される接頭辞。 いいえ；デフォルトは接頭辞なし

ネストされた要素として指定されたパラメーター

このタスクは <format> ネストされた要素をサポートしており、指定した形式でプロパティを現在の日付と時刻に設定できます。日付/時刻パターンは、Java SimpleDateFormat クラスで定義されています。format 要素では、オフセットを時刻に適用することで、異なる時刻値を生成することもできます。

属性 説明 必須
property 指定したパターンで日付/時刻文字列を受け取るプロパティ。 はい
pattern 使用される日付/時刻パターン。値は、Java SimpleDateFormat クラスで定義されています。 はい
timezone 時刻を表示するために使用するタイムゾーン。値は、Java TimeZone クラスで定義されています。 いいえ
offset 現在時刻からの数値オフセット いいえ
unit 現在時刻に適用されるオフセットの単位。有効な値は次のとおりです。
  • millisecond
  • second
  • minute
  • hour
  • day
  • week
  • month
  • year
 いいえ
locale 日付/時刻文字列を作成するために使用されるロケール。一般的な形式は language[, country[, variant]] です（variant、または variant と country の両方を省略できます）。詳細については、Locale クラスのドキュメントを参照してください。 いいえ

例

デフォルトフォーマットに従って、標準 DSTAMP、TSTAMP、および TODAY プロパティを設定します。

<tstamp/>

日付/時刻パターン d-MMMM-yyyy、ロケールは英語（例: 21-May-2001）を使用して、標準プロパティと TODAY_UK を設定します。

<tstamp>
    <format property="TODAY_GB" pattern="d-MMMM-yyyy" locale="en,GB"/>
</tstamp>

touch.time プロパティに現在時刻の 5 時間前のタイムスタンプを作成します。この例の形式は、<touch> タスクと組み合わせて使用できます。標準プロパティも設定されます。

<tstamp>
    <format property="touch.time" pattern="MM/dd/yyyy hh:mm aa"
            offset="-5" unit="hour"/>
</tstamp>

標準フォーマットを使用して次の3つのプロパティを、start.を接頭辞として設定します。start.DSTAMP、start.TSTAMP、start.TODAY。

<tstamp prefix="start"/>