1r.timestamp(1) GRASS GIS User's Manual r.timestamp(1)
2
6 r.timestamp - Modifies a timestamp for a raster map.
7 Print/add/remove a timestamp for a raster map.
8
10 raster, metadata, timestamp, time
11
13 r.timestamp
14 r.timestamp --help
15 r.timestamp map=name [date=timestamp] [--help] [--verbose]
16 [--quiet] [--ui]
17 Flags:
19 --help
20 Print usage summary
21 --verbose
23 Verbose module output
24 --quiet
26 Quiet module output
27 --ui
29 Force launching GUI dialog
30 Parameters:
32 map=name [required]
33 Name of raster map
34 date=timestamp
36 Datetime, datetime1/datetime2, or ’none’ to remove
37 Format: ’15 jan 1994’ (absolute) or ’2 years’ (relative)
38
40 This command has 2 modes of operation. If no date argument is supplied,
41 then the current timestamp for the raster map is printed. If a date ar‐
42 gument is specified, then the timestamp for the raster map is set to
43 the specified date(s). See examples below.
44
46 Strings containing spaces should be quoted. For specifying a range of
47 time, the two timestamps should be separated by a forward slash. To re‐
48 move the timestamp from a raster map, use date=none.
49
51 The timestamp values must use the format as described in the GRASS
52 Datetime Library. The source tree for this library should have a de‐
53 scription of the format. For convenience, the formats are reproduced
54 here:
55 There are two types of datetime values:
57 • absolute and
59 • relative.
61 Absolute values specify exact dates and/or times. Relative values spec‐
62 ify a span of time.
63 Absolute
65 The general format for absolute values is:
66 day month year [bc] hour:minute:seconds timezone
67 day is 1-31
68 month is jan,feb,...,dec
69 year is 4 digit year
70 [bc] if present, indicates dates is BC
71 hour is 0-23 (24 hour clock)
72 minute is 0-59
73 second is 0-59.9999 (fractions of second allowed)
74 timezone is +hhmm or -hhmm (eg, -0600)
75 Some parts can be missing, for example
76 1994 [bc]
77 Jan 1994 [bc]
78 15 jan 1000 [bc]
79 15 jan 1994 [bc] 10 [+0000]
80 15 jan 1994 [bc] 10:00 [+0100]
81 15 jan 1994 [bc] 10:00:23.34 [-0500]
82 Relative
84 There are two types of relative datetime values, year-month and
85 day-second. The formats are:
86 [-] # years # months
87 [-] # days # hours # minutes # seconds
88 The words years, months, days, hours, minutes, seconds are literal
89 words, and the # are the numeric values. Examples:
90 2 years
91 5 months
92 2 years 5 months
93 100 days
94 15 hours 25 minutes 35.34 seconds
95 100 days 25 minutes
96 1000 hours 35.34 seconds
97 The following are illegal because it mixes year-month and day-second
98 (because the number of days in a month or in a year vary):
99 3 months 15 days
100 3 years 10 days
101
103 Prints the timestamp for the "soils" raster map. If there is no time‐
104 stamp for "soils", nothing is printed. If there is a timestamp, one or
105 two time strings are printed, depending on if the timestamp for the map
106 consists of a single date or two dates (ie start and end dates).
107 r.timestamp map=soils
108 Sets the timestamp for "soils" to the single date "15 sep 1987".
109 r.timestamp map=soils date=’15 sep 1987’
110 Sets the timestamp for "soils" to have the start date "15 sep 1987" and
111 the end date "20 feb 1988".
112 r.timestamp map=soils date=’15 sep 1987/20 feb 1988’
113 Sets the timestamp for "soils" to have the start date "18 feb 2005
114 10:30:00" and the end date "20 jul 2007 20:30:00".
115 r.timestamp map=soils date=’18 feb 2005 10:30:00/20 jul 2007 20:30:00’
116 Removes the timestamp for the "soils" raster map.
117 r.timestamp map=soils date=none
118
120 Spaces in the timestamp value are required.
121
123 r.info, r3.timestamp, v.timestamp
124
126 Michael Shapiro, U.S.Army Construction Engineering Research Laboratory
127
129 Available at: r.timestamp source code (history)
130 Accessed: Saturday Oct 28 18:18:06 2023
132 Main index | Raster index | Topics index | Keywords index | Graphical
134 index | Full index
135 © 2003-2023 GRASS Development Team, GRASS GIS 8.3.1 Reference Manual
137GRASS 8.3.1 r.timestamp(1)