一、概述
tstamp是Ant内置任务,用于在当前project中设置DSTAMP、TSTAMP和TODAY属性。默认情况 下,DSTAMP属性的格式为“yyyyMMdd”,TSTAMP属性的格式为“hhmm”,TODAY属性的格式为“MMMM dd yyyy”,可以嵌套format元素来指定其他的格式。可以在构建文件中使用这些属性来创建时间戳文件名,或者替换文档中的占位标记符。最可能用到此任务的是初始化target。
二、属性
prefix:所有设置的属性的前缀。默认无前缀。
tstamp还支持以下嵌套元素:
format:将属性值设置为指定格式的当前日期和时间。时间/日期格式定义在java.text.SimpleDateFormat类中。还可以将偏移量应用到时间来生成不同的时间值。
property:接收以指定格式生成的时间/日期字符串。
pattern:使用的时间/日期格式,时间/日期格式定义在java.text.SimpleDateFormat类中。
timezone:显示时间使用的时区,时区定义在java.util.TimeZone类中。
offset:当前时间的偏移数值。
unit:偏移量单位,可选值为:millisecond、second、minute、hour、day、week、month、year。
locale:用于创建时间/日期字符串的区域设置。通常格式为“language, country, variant”,但是variant或者variant和country可以忽略。 具体可参考java.util.Locale类。
三、简单示例
<project>
<tstamp prefix="time">
<format property="ago" pattern="MM/dd/yyyy hh:mm " offset="-5" unit="hour"/>
</tstamp>
<echo message="time.DSTAMP=${time.DSTAMP},time.ago=${time.ago}"/>
</project>