help/dates.txt
changeset 9539 c904e76e3834
child 9540 cad36e496640
equal deleted inserted replaced
9538:f96ee862aba0 9539:c904e76e3834
       
     1     Some commands allow the user to specify a date, e.g.:
       
     2 
       
     3     - backout, commit, import, tag: Specify the commit date.
       
     4     - log, revert, update: Select revision(s) by date.
       
     5 
       
     6     Many date formats are valid. Here are some examples::
       
     7 
       
     8       "Wed Dec 6 13:18:29 2006" (local timezone assumed)
       
     9       "Dec 6 13:18 -0600" (year assumed, time offset provided)
       
    10       "Dec 6 13:18 UTC" (UTC and GMT are aliases for +0000)
       
    11       "Dec 6" (midnight)
       
    12       "13:18" (today assumed)
       
    13       "3:39" (3:39AM assumed)
       
    14       "3:39pm" (15:39)
       
    15       "2006-12-06 13:18:29" (ISO 8601 format)
       
    16       "2006-12-6 13:18"
       
    17       "2006-12-6"
       
    18       "12-6"
       
    19       "12/6"
       
    20       "12/6/6" (Dec 6 2006)
       
    21 
       
    22     Lastly, there is Mercurial's internal format::
       
    23 
       
    24       "1165432709 0" (Wed Dec 6 13:18:29 2006 UTC)
       
    25 
       
    26     This is the internal representation format for dates. unixtime is
       
    27     the number of seconds since the epoch (1970-01-01 00:00 UTC).
       
    28     offset is the offset of the local timezone, in seconds west of UTC
       
    29     (negative if the timezone is east of UTC).
       
    30 
       
    31     The log command also accepts date ranges::
       
    32 
       
    33       "<{datetime}" - at or before a given date/time
       
    34       ">{datetime}" - on or after a given date/time
       
    35       "{datetime} to {datetime}" - a date range, inclusive
       
    36       "-{days}" - within a given number of days of today