comparison doc/hg.1.txt @ 3257:c9cd63a6fce9

Add documentation about the date formats allowed in the command line
author Jose M. Prieto <jmprieto@gmx.net>
date Tue, 03 Oct 2006 12:33:22 +0200
parents b9dbbcf8a488
children c05b0cc6b148
comparison
equal deleted inserted replaced
3256:e5c9a084ffe3 3257:c9cd63a6fce9
125 order. 125 order.
126 126
127 A range acts as a closed interval. This means that a range of 3:5 127 A range acts as a closed interval. This means that a range of 3:5
128 gives 3, 4 and 5. Similarly, a range of 4:2 gives 4, 3, and 2. 128 gives 3, 4 and 5. Similarly, a range of 4:2 gives 4, 3, and 2.
129 129
130 DATE FORMATS
131 ------------
132
133 Some commands (backout, commit, tag) allow the user to specify a date.
134 Possible formats for dates are:
135
136 YYYY-mm-dd \HH:MM[:SS] [(+|-)NNNN]::
137 This is a subset of ISO 8601, allowing just the recommended notations
138 for date and time. The last part represents the timezone; if omitted,
139 local time is assumed. Examples:
140
141 "2005-08-22 03:27 -0700"
142
143 "2006-04-19 21:39:51"
144
145 aaa bbb dd HH:MM:SS YYYY [(+|-)NNNN]::
146 This is the date format used by the C library. Here, aaa stands for
147 abbreviated weekday name and bbb for abbreviated month name. The last
148 part represents the timezone; if omitted, local time is assumed.
149 Examples:
150
151 "Mon Aug 22 03:27:00 2005 -0700"
152
153 "Wed Apr 19 21:39:51 2006"
154
155 unixtime offset::
156 This is the internal representation format for dates. unixtime is
157 the number of seconds since the epoch (1970-01-01 00:00 UTC). offset
158 is the offset of the local timezone, in seconds west of UTC (negative
159 if the timezone is east of UTC).
160 Examples:
161
162 "1124706420 25200" (2005-08-22 03:27:00 -0700)
163
164 "1145475591 -7200" (2006-04-19 21:39:51 +0200)
165
130 ENVIRONMENT VARIABLES 166 ENVIRONMENT VARIABLES
131 --------------------- 167 ---------------------
132 168
133 HGEDITOR:: 169 HGEDITOR::
134 This is the name of the editor to use when committing. Defaults to the 170 This is the name of the editor to use when committing. Defaults to the