r.timestamp(1)		      Grass User's Manual		r.timestamp(1)



NNAAMMEE
       rr..ttiimmeessttaammpp print/add/remove a timestamp for a raster map
       _(_G_R_A_S_S _R_a_s_t_e_r _P_r_o_g_r_a_m_)

SSYYNNOOPPSSIISS
       rr..ttiimmeessttaammpp
       rr..ttiimmeessttaammpp hheellpp
       rr..ttiimmeessttaammpp mmaapp==_n_a_m_e [ddaattee==_t_i_m_e_s_t_a_m_p[/_t_i_m_e_s_t_a_m_p]]

DDEESSCCRRIIPPTTIIOONN
       This command has 2 modes of operation. If no date 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.

OOPPTTIIOONNSS
   PPaarraammeetteerrss::
       mmaapp==_n_a_m_e
	      Name of raster map.

       ddaattee==_t_i_m_e_s_t_a_m_p[/_t_i_m_e_s_t_a_m_p] or _n_o_n_e
	      String specifying timestamp, range, or _n_o_n_e. See FORMAT below.


NNOOTTEESS
       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 ddaattee==_n_o_n_e.

EEXXAAMMPPLLEESS
       rr..ttiimmeessttaammpp mmaapp==ssooiillss

       Prints the timestamp for the "soils" raster map. If there is  no  time-
       stamp  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).


	    rr..ttiimmeessttaammpp mmaapp==ssooiillss ddaattee==''1155 sseepp 11998877''

       Sets the timestamp for "soils" to the single date

       "15 sep 1987"


	    rr..ttiimmeessttaammpp mmaapp==ssooiillss ddaattee==''1155 sseepp 11998877//2200 ffeebb 11998888''

       Sets the timestamp for "soils" to have the start date

       "15 sep 1987" and the end date "20 feb 1988"


	    rr..ttiimmeessttaammpp mmaapp==ssooiillss ddaattee==nnoonnee

       Removes the timestamp for the "soils" raster map

TTIIMMEESSTTAAMMPP FFOORRMMAATT
       The  timestamp  values  must  use  the format as described in the GRASS
       datetime library.  The source tree  for	this  library  should  have  a
       description  of	the format. For convience, the formats as of Feb, 1996
       are reproduced here:


       There are two types of datetime values: absolute and relative. Absolute
       values  specify	exact  dates  and/or times.  Relative values specify a
       span of time. Some examples will help clarify:


       AAbbssoolluuttee


       The general format for absolute values is:


       day month year [bc] hour:minute:seconds timezone


       day is 1-31

       month is jan,feb,...,dec

       year is 4 digit year

       [bc] if present, indicates dates is BC

       hour is 0-23 (24 hour clock)

       mintue is 0-59

       second is 0-59.9999 (fractions of second allowed)

       timezone is +hhmm or -hhmm (eg, -0600)



       parts can be missing


       1994 [bc]

       Jan 1994 [bc]

       15 jan 1000 [bc]

       15 jan 1994 [bc] 10 [+0000]

       15 jan 1994 [bc] 10:00 [+0100]

       15 jan 1994 [bc] 10:00:23.34 [-0500]



       RReellaattiivvee


       There are two types of relative datetime values, year- month  and  day-
       second.	   The formats are:


       [-] # years # months

       [-] # days # hours # minutes # seconds


       The  words  years,  months,  days,  hours, minutes, seconds are literal
       words, and the # are the numeric values.

       Examples:


       2 years

       5 months

       2 years 5 months

       100 days

       15 hours 25 minutes 35.34 seconds

       100 days 25 minutes

       1000 hours 35.34 seconds


       The following are _i_l_l_e_g_a_l because it mixes  year-month  and  day-second
       (because the number of days in a month or in a year vary):


       3 months 15 days

       3 years 10 days

SSEEEE AALLSSOO
       _v_._t_i_m_e_s_t_a_m_p



BBUUGGSS
       Spaces in the timestamp value are required.

AAUUTTHHOORR
       Michael Shapiro,

       U.S.Army Construction Engineering Research Laboratory

       _L_a_s_t _c_h_a_n_g_e_d_: _$_D_a_t_e_: _2_0_0_3_/_0_3_/_1_6 _1_2_:_2_5_:_1_9 _$



GRASS 5.0							r.timestamp(1)
