# Ant User Manual

## Tstamp

### Description

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

These properties can be used in the build-file, for instance, to create time-stamped filenames, or used to replace placeholder tags inside documents to indicate, for example, the release date. The best place for this task is probably in an initialization target.

### Parameters

Attribute | Description | Required
No parameters

### Nested Elements

The Tstamp task supports a `<format>` nested element that allows a property to be set to 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 to receive the date/time string in the given pattern. | Yes
pattern | The date/time pattern to be used. The values are as defined by the Java SimpleDateFormat class. | Yes

### Examples

      <tstamp/>

sets the standard `DSTAMP`, `TSTAMP`, and `TODAY` properties according to the default formats.

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

sets the standard properties as well as the property `TODAY_UK` with the date/time pattern "d-MMMM-yyyy" (eg., 21-May-2001).

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