1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
|
<!--
Licensed to the Apache Software Foundation (ASF) under one or more
contributor license agreements. See the NOTICE file distributed with
this work for additional information regarding copyright ownership.
The ASF licenses this file to You under the Apache License, Version 2.0
(the "License"); you may not use this file except in compliance with
the License. You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
-->
<html>
<head>
<meta http-equiv="Content-Language" content="en-us">
<link rel="stylesheet" type="text/css" href="../stylesheets/style.css">
<title>TStamp Task</title>
</head>
<body>
<h2 id="tstamp">Tstamp</h2>
<h3>Description</h3>
<p>Sets the <code>DSTAMP</code>, <code>TSTAMP</code>, and <code>TODAY</code> properties in the
current project. By default, the <code>DSTAMP</code> property is in the
format <q>yyyyMMdd</q>, <code>TSTAMP</code> is in the format <q>hhmm</q>, and <code>TODAY</code> is
in the format <q>MMMM dd yyyy</q>. Use the nested <code><format></code> element to specify a
different format.</p>
<p>These properties can be used in the build file, 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 probably in an initialization target.</p>
<p><em>Since Ant 1.10.2</em> the magic property <code>ant.tstamp.now</code> can be used to specify a
fixed date value in order to create reproducible builds. Its value must be a number and is
interpreted as seconds since the epoch (midnight 1970-01-01). With <code>ant.tstamp.now.iso</code>
you could also specify that value in ISO-8601 format (<code>1972-04-17T08:07:00Z</code>). If you
specify a value in an invalid format an INFO message will be logged and the value will be
ignored.</p>
<h3>Parameters</h3>
<table class="attr">
<tr>
<th>Attribute</th>
<th>Description</th>
<th>Required</th>
</tr>
<tr>
<td>prefix</td>
<td>Prefix used for all properties set.</td>
<td>No; default is no prefix</td>
</tr>
</table>
<h3>Parameters specified as nested elements</h3>
<p>The task supports a <code><format></code> 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 <a href="https://docs.oracle.com/javase/8/docs/api/java/text/SimpleDateFormat.html">SimpleDateFormat</a>
class. The format element also allows offsets to be applied to the time to generate different time
values.</p>
<table class="attr">
<tr>
<th>Attribute</th>
<th>Description</th>
<th>Required</th>
</tr>
<tr>
<td>property</td>
<td>The property to receive the date/time string in the given pattern.</td>
<td>Yes</td>
</tr>
<tr>
<td>pattern</td>
<td>The date/time pattern to be used. The values are as defined by the Java SimpleDateFormat
class.</td>
<td>Yes</td>
</tr>
<tr>
<td>timezone</td>
<td>The timezone to use for displaying time. The values are as defined by the
Java <a href="https://docs.oracle.com/javase/8/docs/api/java/util/TimeZone.html">TimeZone</a>
class.</td>
<td>No</td>
</tr>
<tr>
<td>offset</td>
<td>The numeric offset to the current time</td>
<td>No</td>
</tr>
<tr>
<td>unit</td>
<td>The unit of the offset to be applied to the current time. Valid values are
<ul>
<li><q>millisecond</q></li>
<li><q>second</q></li>
<li><q>minute</q></li>
<li><q>hour</q></li>
<li><q>day</q></li>
<li><q>week</q></li>
<li><q>month</q></li>
<li><q>year</q></li>
</ul>
</td>
<td>No</td>
</tr>
<tr>
<td>locale</td>
<td>The locale used to create date/time string. The general form is <q>language[, country[,
variant]]</q> (either <q>variant</q> or both <q>variant</q> and <q>country</q> may be
omitted). For more information please refer to documentation for
the <a href="https://docs.oracle.com/javase/8/docs/api/java/util/Locale.html">Locale</a>
class.</td>
<td>No</td>
</tr>
</table>
<h3>Examples</h3>
<pre><tstamp/></pre>
<p>sets the standard <code>DSTAMP</code>, <code>TSTAMP</code>, and <code>TODAY</code> properties
according to the default formats.</p>
<pre>
<tstamp>
<format property="TODAY_GB" pattern="d-MMMM-yyyy" locale="en,GB"/>
</tstamp></pre>
<p>sets the standard properties as well as the property <code>TODAY_UK</code> with the date/time
pattern <q>d-MMMM-yyyy</q> using English locale (eg. 21-May-2001).</p>
<pre>
<tstamp>
<format property="touch.time" pattern="MM/dd/yyyy hh:mm aa"
offset="-5" unit="hour"/>
</tstamp></pre>
<p>Creates a timestamp, in the property <code>touch.time</code>, 5 hours before the current
time. The format in this example is suitable for use with the <code><touch></code> task. The
standard properties are set also.</p>
<pre><tstamp prefix="start"/></pre>
<p>Sets three properties with the standard formats, prefixed
with <q>start.</q>: <code>start.DSTAMP</code>, <code>start.TSTAMP</code>,
and <code>start.TODAY</code>.</p>
</body>
</html>
|
