comparison mercurial/help.py @ 3813:6fa11a9d7cac

Update dates help topic
author Matt Mackall <mpm@selenic.com>
date Wed, 06 Dec 2006 13:36:23 -0600
parents eb66d76c7746
children dbd828167384
comparison
equal deleted inserted replaced
3812:1d571ed26eed 3813:6fa11a9d7cac
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::