3
This command has 2 modes of operation. If no date argument is supplied, then
4
the current timestamp for the raster map is printed. If a date argument is
5
specified, then the timestamp for the raster map is set to the specified
6
date(s). See EXAMPLES below.
3
This command has 2 modes of operation. If no <b>date</b> argument is
4
supplied, then the current timestamp for the raster map is printed. If
5
a date argument is specified, then the timestamp for the raster map is
6
set to the specified date(s). See examples below.
10
Strings containing spaces should be quoted. For specifying a range
11
of time, the two timestamps should be separated by a forward slash.
12
To remove the timestamp from a raster map, use <b>date=</b><em>none</em>.
16
<b>r.timestamp map=soils</b><br>
17
Prints the timestamp for the "soils" raster map. If
18
there is no timestamp for soils, nothing is printed. If
19
there is a timestamp, one or two time strings are printed,
20
depending on if the timestamp for the map consists of a
21
single date or two dates (ie start and end dates).
23
<b> r.timestamp map=soils date='15 sep 1987'</b><br>
24
Sets the timestamp for "soils" to the single date<br>
27
<b> r.timestamp map=soils date='15 sep 1987/20 feb 1988'</b><br>
28
Sets the timestamp for "soils" to have the start date<br>
29
"15 sep 1987" and the end date "20 feb 1988"
31
<b> r.timestamp map=soils date=none</b><br>
32
Removes the timestamp for the "soils" raster map
10
Strings containing spaces should be quoted. For specifying a range of
11
time, the two timestamps should be separated by a forward slash. To
12
remove the timestamp from a raster map, use <b>date=none</b>.
35
14
<h2>TIMESTAMP FORMAT</h2>
36
The timestamp values must use the format as described in the
37
GRASS datetime library. The source tree for this library
38
should have a description of the format. For convience, the
39
formats as of Feb, 1996 are reproduced here:
41
There are two types of datetime values: absolute and
42
relative. Absolute values specify exact dates and/or times.
43
Relative values specify a span of time. Some examples will
47
The general format for absolute values is:
49
day month year [bc] hour:minute:seconds timezone
52
month is jan,feb,...,dec<br>
53
year is 4 digit year<br>
54
[bc] if present, indicates dates is BC<br>
55
hour is 0-23 (24 hour clock)<br>
57
second is 0-59.9999 (fractions of second allowed)<br>
58
timezone is +hhmm or -hhmm (eg, -0600)<br>
65
15 jan 1994 [bc] 10 [+0000]<br>
66
15 jan 1994 [bc] 10:00 [+0100]<br>
67
15 jan 1994 [bc] 10:00:23.34 [-0500]<br>
71
There are two types of relative datetime values, year-
72
month and day-second. The formats are:
74
[-] # years # months<br>
16
The timestamp values must use the format as described in the <em>GRASS
17
Datetime Library</em>. The source tree for this library should have a
18
description of the format. For convience, the formats are reproduced
22
There are two types of datetime values:
25
<li><em>absolute</em> and
26
<li><em>relative</em>.
29
Absolute values specify exact dates and/or times. Relative values
30
specify a span of time.
34
The general format for absolute values is:
36
<div class="code"><pre>
37
day month year [bc] hour:minute:seconds timezone
40
month is jan,feb,...,dec
42
[bc] if present, indicates dates is BC
43
hour is 0-23 (24 hour clock)
45
second is 0-59.9999 (fractions of second allowed)
46
timezone is +hhmm or -hhmm (eg, -0600)
49
Some parts can be missing, for example
51
<div class="code"><pre>
55
15 jan 1994 [bc] 10 [+0000]
56
15 jan 1994 [bc] 10:00 [+0100]
57
15 jan 1994 [bc] 10:00:23.34 [-0500]
62
There are two types of relative datetime values, year-month and
63
day-second. The formats are:
65
<div class="code"><pre>
75
67
[-] # days # hours # minutes # seconds
77
The words years, months, days, hours, minutes, seconds
78
are literal words, and the # are the numeric values.<br>
85
15 hours 25 minutes 35.34 seconds<br>
86
100 days 25 minutes<br>
70
The words years, months, days, hours, minutes, seconds are literal
71
words, and the # are the numeric values. Examples:
73
<div class="code"><pre>
78
15 hours 25 minutes 35.34 seconds
87
80
1000 hours 35.34 seconds
89
The following are <i>illegal</i> because it mixes year-month
90
and day-second (because the number of days in a month
91
or in a year vary):<p>
83
The following are <i>illegal</i> because it mixes year-month and
84
day-second (because the number of days in a month or in a year vary):
86
<div class="code"><pre>
99
<em><a HREF="v.timestamp.html">v.timestamp</a></em>
93
Prints the timestamp for the "soils" raster map. If there is no
94
timestamp for "soils", nothing is printed. If there is a timestamp,
95
one or two time strings are printed, depending on if the timestamp for
96
the map consists of a single date or two dates (ie start and end
99
<div class="code"><pre>
100
r.timestamp map=soils
103
Sets the timestamp for "soils" to the single date "15 sep 1987".
105
<div class="code"><pre>
106
r.timestamp map=soils date='15 sep 1987'
109
Sets the timestamp for "soils" to have the start date "15 sep 1987"
110
and the end date "20 feb 1988".
112
<div class="code"><pre>
113
r.timestamp map=soils date='15 sep 1987/20 feb 1988'
116
Removes the timestamp for the "soils" raster map.
118
<div class="code"><pre>
119
r.timestamp map=soils date=none
102
123
Spaces in the timestamp value are required.
128
<a href="r.info.html">r.info</a>
106
Michael Shapiro, <br>
107
U.S.Army Construction Engineering Research Laboratory
133
Michael Shapiro, U.S.Army Construction Engineering Research Laboratory
109
<p><i>Last changed: $Date: 2008-05-16 21:09:06 +0200 (ven, 16 mag 2008) $</i>
136
<i>Last changed: $Date: 2010-10-24 11:19:19 +0200 (Sun, 24 Oct 2010) $</i>
added
removed
raster/r.timestamp/description.html
