← Back to branch summary

~ubuntu-branches/ubuntu/wily/grass/wily

« back to all changes in this revision

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

Tags: 7.0.0~rc1+ds1-1~exp1
http://bugs.debian.org/776349
* New upstream release candidate.
* Repack upstream tarball, remove precompiled Python objects.
* Add upstream metadata.
* Update gbp.conf and Vcs-Git URL to use the experimental branch.
* Update watch file for GRASS 7.0.
* Drop build dependencies for Tcl/Tk, add build dependencies:
  python-numpy, libnetcdf-dev, netcdf-bin, libblas-dev, liblapack-dev
* Update Vcs-Browser URL to use cgit instead of gitweb.
* Update paths to use grass70.
* Add configure options: --with-netcdf, --with-blas, --with-lapack,
  remove --with-tcltk-includes.
* Update patches for GRASS 7.
* Update copyright file, changes:
  - Update copyright years
  - Group files by license
  - Remove unused license sections
* Add patches for various typos.
* Fix desktop file with patch instead of d/rules.
* Use minimal dh rules.
* Bump Standards-Version to 3.9.6, no changes.
* Use dpkg-maintscript-helper to replace directories with symlinks.
  (closes: #776349)
* Update my email to use @debian.org address.

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>