← Back to branch summary

~ubuntu-branches/ubuntu/vivid/grass/vivid-proposed

« back to all changes in this revision

Viewing changes to raster/r.timestamp/r.timestamp.html

  • Committer: Package Import Robot
  • Author(s): Bas Couwenberg
  • Date: 2015-02-20 23:12:08 UTC
  • mfrom: (8.2.6 experimental)
  • Revision ID: package-import@ubuntu.com-20150220231208-1u6qvqm84v430b10
Tags: 7.0.0-1~exp1
* New upstream release.
* Update python-ctypes-ternary.patch to use if/else instead of and/or.
* Drop check4dev patch, rely on upstream check.
* Add build dependency on libpq-dev to grass-dev for libpq-fe.h.
* Drop patches applied upstream, refresh remaining patches.
* Update symlinks for images switched from jpg to png.

Show diffs side-by-side

added added

removed removed

Lines of Context:
raster/r.timestamp/r.timestamp.html
 
1
<h2>DESCRIPTION</h2>
 
2
 
 
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.
 
7
 
 
8
<h2>NOTES</h2>
 
9
 
 
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>.
 
13
 
 
14
<h2>TIMESTAMP FORMAT</h2>
 
15
 
 
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
 
19
here:
 
20
 
 
21
<p>There are two types of datetime values:
 
22
 
 
23
<ul>
 
24
  <li><em>absolute</em> and
 
25
  <li><em>relative</em>.
 
26
</ul>
 
27
 
 
28
Absolute values specify exact dates and/or times. Relative values
 
29
specify a span of time. 
 
30
 
 
31
<h3>Absolute</h3>
 
32
 
 
33
The general format for absolute values is:
 
34
 
 
35
<div class="code"><pre>
 
36
  day month year [bc] hour:minute:seconds timezone
 
37
 
 
38
             day is 1-31
 
39
             month is jan,feb,...,dec
 
40
             year is 4 digit year
 
41
             [bc] if present, indicates dates is BC
 
42
             hour is 0-23 (24 hour clock)
 
43
             minute is 0-59
 
44
             second is 0-59.9999 (fractions of second allowed)
 
45
             timezone is +hhmm or -hhmm (eg, -0600)
 
46
</pre></div>
 
47
 
 
48
Some parts can be missing, for example
 
49
 
 
50
<div class="code"><pre>
 
51
             1994 [bc]
 
52
             Jan 1994 [bc]
 
53
             15 jan 1000 [bc]
 
54
             15 jan 1994 [bc] 10 [+0000]
 
55
             15 jan 1994 [bc] 10:00 [+0100]
 
56
             15 jan 1994 [bc] 10:00:23.34 [-0500]
 
57
</pre></div>
 
58
 
 
59
<h3>Relative</h3>
 
60
 
 
61
There are two types of relative datetime values, year-month and
 
62
day-second. The formats are:
 
63
 
 
64
<div class="code"><pre>
 
65
             [-] # years # months
 
66
             [-] # days # hours # minutes # seconds
 
67
</pre></div>
 
68
 
 
69
The words years, months, days, hours, minutes, seconds are literal
 
70
words, and the # are the numeric values. Examples:
 
71
 
 
72
<div class="code"><pre>
 
73
             2 years
 
74
             5 months
 
75
             2 years 5 months
 
76
             100 days
 
77
             15 hours 25 minutes 35.34 seconds
 
78
             100 days 25 minutes
 
79
             1000 hours 35.34 seconds
 
80
</pre></div>
 
81
 
 
82
The following are <i>illegal</i> because it mixes year-month and
 
83
day-second (because the number of days in a month or in a year vary):
 
84
 
 
85
<div class="code"><pre>
 
86
             3 months 15 days
 
87
             3 years 10 days
 
88
</pre></div>
 
89
 
 
90
<h2>EXAMPLES</h2>
 
91
 
 
92
Prints the timestamp for the "soils" raster map. If there is no
 
93
timestamp for "soils", nothing is printed. If there is a timestamp,
 
94
one or two time strings are printed, depending on if the timestamp for
 
95
the map consists of a single date or two dates (ie start and end
 
96
dates).
 
97
 
 
98
<div class="code"><pre>
 
99
    r.timestamp map=soils
 
100
</pre></div>
 
101
 
 
102
Sets the timestamp for "soils" to the single date "15 sep 1987".
 
103
 
 
104
<div class="code"><pre>
 
105
    r.timestamp map=soils date='15 sep 1987'
 
106
</pre></div>
 
107
 
 
108
Sets the timestamp for "soils" to have the start date "15 sep 1987"
 
109
and the end date "20 feb 1988".
 
110
 
 
111
<div class="code"><pre>
 
112
    r.timestamp map=soils date='15 sep 1987/20 feb 1988'
 
113
</pre></div>
 
114
 
 
115
Removes the timestamp for the "soils" raster map.
 
116
 
 
117
<div class="code"><pre>
 
118
    r.timestamp map=soils date=none
 
119
</pre></div>
 
120
 
 
121
<h2>BUGS</h2>
 
122
Spaces in the timestamp value are required.
 
123
 
 
124
<h2>SEE ALSO</h2>
 
125
 
 
126
<em>
 
127
  <a href="r.info.html">r.info</a>
 
128
</em>
 
129
 
 
130
<h2>AUTHOR</h2>
 
131
 
 
132
Michael Shapiro, U.S.Army Construction Engineering Research Laboratory
 
133
 
 
134
<p><i>Last changed: $Date: 2012-01-28 12:56:15 -0800 (Sat, 28 Jan 2012) $</i>