# Ant User Manual

## Tstamp

### Description

Sets the DSTAMP, TSTAMP and TODAY properties in the current project. The DSTAMP is in the "yyyymmdd" format, the TSTAMP is in the "hhmm" format and TODAY is "month day year".

These properties can be used in the buildfile, for instance, to create timestamped filenames or used to replace placeholder tags inside documents to indicate, for example, the release date. The best place for this task is in your initialization target.

### Parameters

Attribute | Description | Required
No parameters

### Nested Elements

The tstamp task supports a format nested element which allows a property to be given the current date and time in a given format. The date/time patterns are as defined in the Java SimpleDateFormat class.

Attribute | Description | Required
property | The property which is to receive the date/time string in the given pattern | Yes
pattern | The date/time pattern to be used. The values are defined by the Java SimpleDateFormat class | Yes

### Examples

Set the standard DSTAMP, TSTAMP and TODAY properties according to the formats above

      <tstamp/>

As for the above example, set the standard properties and also set the property "TODAY_UK" with the date/time pattern "d MMM yyyy"

      <tstamp>
        <format property="TODAY_UK" pattern="d MMMM yyyy">
      </tstamp>

Copyright © 2000,2001 Apache Software Foundation. All rights Reserved.