.TH r.timestamp 1grass "" "GRASS 6.4.4" "Grass User's Manual"
.SH NAME
\fI\fBr.timestamp\fR\fR  - Modifies a timestamp for a raster map.
.br
Print/add/remove a timestamp for a raster map.
.SH KEYWORDS
raster, metadata, timestamp
.SH SYNOPSIS
\fBr.timestamp\fR
.br
\fBr.timestamp help\fR
.br
\fBr.timestamp map\fR=\fIname\fR  [\fBdate\fR=\fItimestamp\fR]   [\-\-\fBverbose\fR]  [\-\-\fBquiet\fR] 
.SS Parameters:
.IP "\fBmap\fR=\fIname\fR" 4m
.br
Name of input raster map
.IP "\fBdate\fR=\fItimestamp\fR" 4m
.br
Datetime, datetime1/datetime2, or 'none' to remove
.br
Format: '15 jan 1994' (absolute) or '2 years' (relative)
.PP
.SH DESCRIPTION
This command has 2 modes of operation. If no \fBdate\fR argument is
supplied, then the current timestamp for the raster map is printed. If
a date argument is specified, then the timestamp for the raster map is
set to the specified date(s). See examples below.
.SH NOTES
Strings containing spaces should be quoted. For specifying a range of
time, the two timestamps should be separated by a forward slash. To
remove the timestamp from a raster map, use \fBdate=none\fR.
.SH TIMESTAMP FORMAT
The timestamp values must use the format as described in the \fIGRASS
Datetime Library\fR. The source tree for this library should have a
description of the format. For convience, the formats are reproduced
here:
.PP
There are two types of datetime values:
.RE
\fIabsolute\fR and
\fIrelative\fR.
.RE
Absolute values specify exact dates and/or times. Relative values
specify a span of time. 
.SS Absolute
The general format for absolute values is:
\fC
.DS
.br
  day month year [bc] hour:minute:seconds timezone
.br
.br
	     day is 1-31
.br
	     month is jan,feb,...,dec
.br
	     year is 4 digit year
.br
	     [bc] if present, indicates dates is BC
.br
	     hour is 0-23 (24 hour clock)
.br
	     minute is 0-59
.br
	     second is 0-59.9999 (fractions of second allowed)
.br
	     timezone is +hhmm or \-hhmm (eg, -0600)
.br
.DE
\fR
Some parts can be missing, for example
\fC
.DS
.br
	     1994 [bc]
.br
	     Jan 1994 [bc]
.br
	     15 jan 1000 [bc]
.br
	     15 jan 1994 [bc] 10 [+0000]
.br
	     15 jan 1994 [bc] 10:00 [+0100]
.br
	     15 jan 1994 [bc] 10:00:23.34 [-0500]
.br
.DE
\fR
.SS Relative
There are two types of relative datetime values, year-month and
day-second. The formats are:
\fC
.DS
.br
	     [-] # years # months
.br
	     [-] # days # hours # minutes # seconds
.br
.DE
\fR
The words years, months, days, hours, minutes, seconds are literal
words, and the # are the numeric values. Examples:
\fC
.DS
.br
	     2 years
.br
	     5 months
.br
	     2 years 5 months
.br
	     100 days
.br
	     15 hours 25 minutes 35.34 seconds
.br
	     100 days 25 minutes
.br
	     1000 hours 35.34 seconds
.br
.DE
\fR
The following are \fIillegal\fR because it mixes year-month and
day-second (because the number of days in a month or in a year vary):
\fC
.DS
.br
	     3 months 15 days
.br
	     3 years 10 days
.br
.DE
\fR
.SH EXAMPLES
Prints the timestamp for the "soils" raster map. If there is no
timestamp for "soils", nothing is printed. If there is a timestamp,
one or two time strings are printed, depending on if the timestamp for
the map consists of a single date or two dates (ie start and end
dates).
\fC
.DS
.br
    r.timestamp map=soils
.br
.DE
\fR
Sets the timestamp for "soils" to the single date "15 sep 1987".
\fC
.DS
.br
    r.timestamp map=soils date='15 sep 1987'
.br
.DE
\fR
Sets the timestamp for "soils" to have the start date "15 sep 1987"
and the end date "20 feb 1988".
\fC
.DS
.br
    r.timestamp map=soils date='15 sep 1987/20 feb 1988'
.br
.DE
\fR
Removes the timestamp for the "soils" raster map.
\fC
.DS
.br
    r.timestamp map=soils date=none
.br
.DE
\fR
.SH BUGS
Spaces in the timestamp value are required.
.SH SEE ALSO
\fI
r.info
\fR
.SH AUTHOR
Michael Shapiro, U.S.Army Construction Engineering Research Laboratory
.PP
\fILast changed: $Date: 2012-01-28 21:54:52 +0100 (Sat, 28 Jan 2012) $\fR
.PP
Full index
.PP
© 2003-2014 GRASS Development Team