1r.timestamp(1)              GRASS GIS User's Manual             r.timestamp(1)
2
3
4

NAME

6       r.timestamp  - Modifies a timestamp for a raster map.
7       Print/add/remove a timestamp for a raster map.
8

KEYWORDS

10       raster, metadata, timestamp, time
11

SYNOPSIS

13       r.timestamp
14       r.timestamp --help
15       r.timestamp    map=name    [date=timestamp]     [--help]    [--verbose]
16       [--quiet]  [--ui]
17
18   Flags:
19       --help
20           Print usage summary
21
22       --verbose
23           Verbose module output
24
25       --quiet
26           Quiet module output
27
28       --ui
29           Force launching GUI dialog
30
31   Parameters:
32       map=name [required]
33           Name of raster map
34
35       date=timestamp
36           Datetime, datetime1/datetime2, or ’none’ to remove
37           Format: ’15 jan 1994’ (absolute) or ’2 years’ (relative)
38

DESCRIPTION

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

NOTES

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

TIMESTAMP FORMAT

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
56       There are two types of datetime values:
57
58absolute and
59
60relative.
61       Absolute values specify exact dates and/or times. Relative values spec‐
62       ify a span of time.
63
64   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
83   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

EXAMPLES

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

KNOWN ISSUES

120       Spaces in the timestamp value are required.
121

SEE ALSO

123        r.info, r3.timestamp, v.timestamp
124

AUTHOR

126       Michael Shapiro, U.S.Army Construction Engineering Research Laboratory
127

SOURCE CODE

129       Available at: r.timestamp source code (history)
130
131       Accessed: Saturday Oct 28 18:18:06 2023
132
133       Main  index  | Raster index | Topics index | Keywords index | Graphical
134       index | Full index
135
136       © 2003-2023 GRASS Development Team, GRASS GIS 8.3.1 Reference Manual
137
138
139
140GRASS 8.3.1                                                     r.timestamp(1)
Impressum