Tstamp

說明

設定目前專案中的 DSTAMP、TSTAMP 和 TODAY 屬性。預設情況下，DSTAMP 屬性格式為 yyyyMMdd，TSTAMP 格式為 hhmm，TODAY 格式為 MMMM dd yyyy。使用巢狀 <format> 元素來指定不同的格式。

這些屬性可以在建置檔案中使用，例如建立帶有時間戳記的檔案名稱，或用於取代文件中的佔位符標籤，例如表示發行日期。這個任務最適合放置在初始化目標中。

自 Ant 1.10.2 起，可以使用神奇屬性 ant.tstamp.now 來指定一個固定的日期值，以便建立可重製的建置。其值必須是數字，並解釋為自紀元（1970-01-01 午夜）以來的秒數。使用 ant.tstamp.now.iso，您也可以使用 ISO-8601 格式（1972-04-17T08:07:00Z）指定該值。如果您指定無效格式的值，將會記錄一則資訊訊息，且該值將會被忽略。

自 Ant 1.10.8 起，將會尊重 SOURCE_DATE_EPOCH 環境變數值（如果已設定）以進行 可重製的建置。如果為該環境變數指定無效值（無法解析為整數），Ant 將會記錄一則偵錯訊息，並改用「目前」日期。

參數

屬性 說明 必要
prefix 用於所有設定屬性的前置詞。 否；預設為無前置詞

指定為巢狀元素的參數

此任務支援 <format> 巢狀元素，允許將屬性設定為特定格式的目前日期和時間。日期/時間模式定義於 Java SimpleDateFormat 類別。格式元素也允許將偏移量套用於時間，以產生不同的時間值。

屬性 說明 必要
property 接收特定模式中日期/時間字串的屬性。 是
pattern 要使用的日期/時間模式。這些值由 Java SimpleDateFormat 類別定義。 是
timezone 用於顯示時間的時區。這些值由 Java TimeZone 類別定義。 否
offset 目前時間的數值偏移量 否
單位 要套用至目前時間的偏移量單位。有效值為
  • 毫秒
  • 秒
  • 分鐘
  • 小時
  • 天
  • 週
  • 月
  • 年
 否
地區 用於建立日期/時間字串的地區。一般格式為 語言[, 國家[, 變體]]（變體 或 變體 和 國家 都可以省略）。如需詳細資訊，請參閱 Locale 類別的說明文件。 否

範例

根據預設格式設定標準的 DSTAMP、TSTAMP 和 TODAY 屬性。

<tstamp/>

設定標準屬性以及屬性 TODAY_UK，其日期/時間模式為 d-MMMM-yyyy，並使用英文地區（例如 21-May-2001）。

<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>

設定三個屬性，其標準格式加上 start. 前綴：start.DSTAMP、start.TSTAMP 和 start.TODAY。

<tstamp prefix="start"/>