Ant: The Definitive Guide

Name

tstamp

Synopsis

Sets the DSTAMP, TSTAMP, and TODAY properties. Additionally, each property is formatted using java.text.SimpleDateFormat according to the formats listed in Table 7-4.

Table 7-4. tstamp formats

Property	Format	Example
DSTAMP	yyyyMMdd	20010916
TSTAMP	HHmm	1923
TODAY	MMMM d yyyy	September 16 2001

Attributes

None.

Content

0..n nested <format> elements (1.3, 1.4)

Supports custom formats. The results of each are placed in a property. Following are the <format> element attributes:

property (1.3, 1.4, String, Y)

The name of the property to place the formatted timestamp in.

pattern (1.3, 1.4, String, Y)

The format pattern as defined by java.text.SimpleDateFormat.

offset (1.3, 1.4, int, N)

The numeric offset to the current time.

unit (1.3, 1.4, String, N)

Defines what the offset parameter is affecting. Legal values are: millisecond, second, minute, hour, day, week, month, and year.

locale (1.4, String, N)

The locale used when constructing the SimpleDateFormat object. See the documentation for java.util.Locale.

Example Usage

Produce three properties containing the current time, one hour prior to the current time, and one minute after the current time. All are formatted like September 16 2001 07:37 PM:

<tstamp> <format property="now" pattern="MMMM d yyyy hh:mm aa"/> <format property="hour_earlier" pattern="MMMM d yyyy hh:mm aa" offset="-1" unit="hour"/> <format property="minute_later" pattern="MMMM d yyyy hh:mm aa" offset="1" unit="minute"/> </tstamp> <!-- now display one ...