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



NNAAMMEE
       rr33..ttiimmeessttaammpp print/add/remove a timestamp for a grid3d map
       _(_G_R_A_S_S _3_D _P_r_o_g_r_a_m_)

SSYYNNOOPPSSIISS
       rr33..ttiimmeessttaammpp
       rr33..ttiimmeessttaammpp hheellpp
       rr33..ttiimmeessttaammpp ggrriidd33dd==_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 grid3d map is  printed.  If  a  date
       argument  is specified, then the timestamp for the grid3d map is set to
       the specified date(s).  See EXAMPLES below.

EEXXAAMMPPLLEESS
       rr33..ttiimmeessttaammpp ggrriidd33dd==ssooiillss

       Prints the timestamp for the "soils" grid3d map. If there is  no  time-
       stamp  for  soils,  nothing is printed. If there is a timestamp, one or
       two lines are printed, depending on if the timestamp for the  map  con-
       sists of a single date or two dates (ie start and end dates).


	    rr33..ttiimmeessttaammpp ggrriidd33dd==ssooiillss ddaattee==''1155 sseepp 11998877''

       Sets the timestamp for "soils" to the single date

       "15 sep 1987"


	    rr33..ttiimmeessttaammpp ggrriidd33dd==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"


	    rr33..ttiimmeessttaammpp ggrriidd33dd==ssooiillss ddaattee==nnoonnee

       Removes the timestamp for the "soils" grid3d map

CCOOMMMMAANNDD LLIINNEE OOPPTTIIOONNSS
       PPaarraammeetteerrss   _g_r_i_d_3_d:    grid3d	map  name  _d_a_t_e:  date/time  stamp  or
       date1,date2 range

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



BBUUGGSS
       Spaces in the timestamp value are required.

AAUUTTHHOORR
       Michael Pelizzari

       Lockheed Martin Space Systems

       based on r.timestamp by 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_2_/_0_1_/_2_5 _0_5_:_4_5_:_3_5 _$



GRASS 5.0						       r3.timestamp(1)
