7 |
7 |
8 helptable = { |
8 helptable = { |
9 "dates|Date Formats": |
9 "dates|Date Formats": |
10 r''' |
10 r''' |
11 Some commands (backout, commit, tag) allow the user to specify a date. |
11 Some commands (backout, commit, tag) allow the user to specify a date. |
12 Possible formats for dates are: |
12 Many date formats are acceptible. Here are some examples: |
13 |
13 |
14 YYYY-mm-dd \HH:MM[:SS] [(+|-)NNNN]:: |
14 "Wed Dec 6 13:18:29 2006" (local timezone assumed) |
15 This is a subset of ISO 8601, allowing just the recommended notations |
15 "Dec 6 13:18 -0600" (year assumed, time offset provided) |
16 for date and time. The last part represents the timezone; if omitted, |
16 "Dec 6 13:18 UTC" (UTC and GMT are aliases for +0000) |
17 local time is assumed. Examples: |
17 "Dec 6" (midnight) |
|
18 "13:18" (today assumed) |
|
19 "3:39" (3:39AM assumed) |
|
20 "3:39pm" (15:39) |
|
21 "2006-12-6 13:18:29" (ISO 8601 format) |
|
22 "2006-12-6 13:18" |
|
23 "2006-12-6" |
|
24 "12-6" |
|
25 "12/6" |
|
26 "12/6/6" (Dec 6 2006) |
|
27 "" (Jan 1 00:00:00 1970 UTC) |
18 |
28 |
19 "2005-08-22 03:27 -0700" |
29 Lastly, there is Mercurial's internal format: |
20 |
30 |
21 "2006-04-19 21:39:51" |
31 "1165432709 0" (Wed Dec 6 13:18:29 2006 UTC) |
22 |
32 |
23 aaa bbb dd HH:MM:SS YYYY [(+|-)NNNN]:: |
|
24 This is the date format used by the C library. Here, aaa stands for |
|
25 abbreviated weekday name and bbb for abbreviated month name. The last |
|
26 part represents the timezone; if omitted, local time is assumed. |
|
27 Examples: |
|
28 |
|
29 "Mon Aug 22 03:27:00 2005 -0700" |
|
30 |
|
31 "Wed Apr 19 21:39:51 2006" |
|
32 |
|
33 unixtime offset:: |
|
34 This is the internal representation format for dates. unixtime is |
33 This is the internal representation format for dates. unixtime is |
35 the number of seconds since the epoch (1970-01-01 00:00 UTC). offset |
34 the number of seconds since the epoch (1970-01-01 00:00 UTC). offset |
36 is the offset of the local timezone, in seconds west of UTC (negative |
35 is the offset of the local timezone, in seconds west of UTC (negative |
37 if the timezone is east of UTC). |
36 if the timezone is east of UTC). |
38 Examples: |
|
39 |
|
40 "1124706420 25200" (2005-08-22 03:27:00 -0700) |
|
41 |
|
42 "1145475591 -7200" (2006-04-19 21:39:51 +0200) |
|
43 ''', |
37 ''', |
44 |
38 |
45 'environment|env|Environment Variables': |
39 'environment|env|Environment Variables': |
46 r''' |
40 r''' |
47 HGEDITOR:: |
41 HGEDITOR:: |