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 timestamp for soils, nothing is printed. If there is
       a timestamp, one or two lines are printed, depending on if
       the timestamp for the map consists 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  con-
       vience, the formats as of Feb, 1996 are reproduced here:


       There are two types of datetime values: absolute and rela-
       tive. 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)
