Sets properties with the current date and time.

By default the NAnt.Core.Tasks.TStampTask displays the current date and time and sets the following properties:

tstamp.date to yyyyMMdd
tstamp.time to HHmm
tstamp.now using the default DateTime.ToString() method

To set an additional property with a custom date/time use the NAnt.Core.Tasks.TStampTask.Property and NAnt.Core.Tasks.TStampTask.Pattern attributes. To set a number of additional properties with the exact same date and time use the NAnt.Core.Tasks.TStampTask.Formatters nested element (see example).

The date and time string displayed by the NAnt.Core.Tasks.TStampTask uses the computer's default long date and time string format. You might consider setting these to the ISO 8601 standard for date and time notation.

Parameters

Attribute	Type	Description	Required
pattern	string	The date/time pattern to be used.	False
property	string	The property to receive the date/time string in the given pattern.	False
failonerror	bool	Determines if task failure stops the build, or is just reported. The default is `true`.	False
if	bool	If `true` then the task will be executed; otherwise, skipped. The default is `true`.	False
unless	bool	Opposite of `NAnt.Core.Task.IfDefined`. If `false` then the task will be executed; otherwise, skipped. The default is `false`.	False
verbose	bool	Determines whether the task should report detailed build log messages. The default is `false`.	False

Nested elements

<formatter>

Automatically validates attributes in the element based on attributes applied to members in derived classes.

Parameters

Attribute	Type	Description	Required
pattern	string	The string pattern to use to format the property.	True
property	string	The name of the NAnt property to set.	True
if	bool	Indicates if the formatter should be used to format the timestamp. If `true` then the formatter will be used; otherwise, skipped. The default is `true`.	False
unless	bool	Indicates if the formatter should be not used to format the timestamp. If `false` then the formatter will be used; otherwise, skipped. The default is `false`.	False

<formatter>

Examples

Set the build.date property.

<tstamp property="build.date" pattern="yyyyMMdd" verbose="true" />

Set a number of properties for Ant like compatibility.

    <tstamp verbose="true">
    <formatter property="TODAY" pattern="dd MMM yyyy"/>
    <formatter property="DSTAMP" pattern="yyyyMMdd" unless="${date.not.needed}" />
    <formatter property="TSTAMP" pattern="HHmm" if="${need.hours}" />
</tstamp>

Requirements

Assembly: NAnt.Core.dll
Namespace: NAnt.Core.Tasks

<tstamp>

Parameters

Nested elements

<formatter>

Parameters

<formatter>

Examples

Requirements