##// END OF EJS Templates
help/dates: rephrase explanation of internal format...
Martin Geisler -
r13882:0a0988bd stable
parent child Browse files
Show More
@@ -1,36 +1,36 b''
1 Some commands allow the user to specify a date, e.g.:
1 Some commands allow the user to specify a date, e.g.:
2
2
3 - backout, commit, import, tag: Specify the commit date.
3 - backout, commit, import, tag: Specify the commit date.
4 - log, revert, update: Select revision(s) by date.
4 - log, revert, update: Select revision(s) by date.
5
5
6 Many date formats are valid. Here are some examples:
6 Many date formats are valid. Here are some examples:
7
7
8 - ``Wed Dec 6 13:18:29 2006`` (local timezone assumed)
8 - ``Wed Dec 6 13:18:29 2006`` (local timezone assumed)
9 - ``Dec 6 13:18 -0600`` (year assumed, time offset provided)
9 - ``Dec 6 13:18 -0600`` (year assumed, time offset provided)
10 - ``Dec 6 13:18 UTC`` (UTC and GMT are aliases for +0000)
10 - ``Dec 6 13:18 UTC`` (UTC and GMT are aliases for +0000)
11 - ``Dec 6`` (midnight)
11 - ``Dec 6`` (midnight)
12 - ``13:18`` (today assumed)
12 - ``13:18`` (today assumed)
13 - ``3:39`` (3:39AM assumed)
13 - ``3:39`` (3:39AM assumed)
14 - ``3:39pm`` (15:39)
14 - ``3:39pm`` (15:39)
15 - ``2006-12-06 13:18:29`` (ISO 8601 format)
15 - ``2006-12-06 13:18:29`` (ISO 8601 format)
16 - ``2006-12-6 13:18``
16 - ``2006-12-6 13:18``
17 - ``2006-12-6``
17 - ``2006-12-6``
18 - ``12-6``
18 - ``12-6``
19 - ``12/6``
19 - ``12/6``
20 - ``12/6/6`` (Dec 6 2006)
20 - ``12/6/6`` (Dec 6 2006)
21
21
22 Lastly, there is Mercurial's internal format:
22 Lastly, there is Mercurial's internal format:
23
23
24 - ``1165432709 0`` (Wed Dec 6 13:18:29 2006 UTC)
24 - ``1165432709 0`` (Wed Dec 6 13:18:29 2006 UTC)
25
25
26 This is the internal representation format for dates. unixtime is the
26 This is the internal representation format for dates. The first number
27 number of seconds since the epoch (1970-01-01 00:00 UTC). offset is
27 is the number of seconds since the epoch (1970-01-01 00:00 UTC). The
28 the offset of the local timezone, in seconds west of UTC (negative if
28 second is the offset of the local timezone, in seconds west of UTC
29 the timezone is east of UTC).
29 (negative if the timezone is east of UTC).
30
30
31 The log command also accepts date ranges:
31 The log command also accepts date ranges:
32
32
33 - ``<{datetime}`` - at or before a given date/time
33 - ``<{datetime}`` - at or before a given date/time
34 - ``>{datetime}`` - on or after a given date/time
34 - ``>{datetime}`` - on or after a given date/time
35 - ``{datetime} to {datetime}`` - a date range, inclusive
35 - ``{datetime} to {datetime}`` - a date range, inclusive
36 - ``-{days}`` - within a given number of days of today
36 - ``-{days}`` - within a given number of days of today
General Comments 0
You need to be logged in to leave comments. Login now