Document date formats accepted by parse_date()
Signed-off-by: Junio C Hamano <gitster@pobox.com>
Miklos Vajna committed
Dec 3, 2009 at 00:49 UTC
788070a261ecc3a37a7e0ed9301ecec4a333586d
3 files changed
+29
Documentation/date-formats.txt
new
+26
@@ -0,0 +1,26 @@
1
+DATE FORMATS
2
+------------
3
+
4
+The GIT_AUTHOR_DATE, GIT_COMMITTER_DATE environment variables
5
+ifdef::git-commit[]
6
+and the `--date` option
7
+endif::git-commit[]
8
+support the following date formats:
9
+
10
+Git internal format::
11
+ It is `<unix timestamp> <timezone offset>`, where `<unix
12
+ timestamp>` is the number of seconds since the UNIX epoch.
13
+ `<timezone offset>` is a positive or negative offset from UTC.
14
+ For example CET (which is 2 hours ahead UTC) is `+0200`.
15
+
16
+RFC 2822::
17
+ The standard email format as described by RFC 2822, for example
18
+ `Thu, 07 Apr 2005 22:13:13 +0200`.
19
+
20
+ISO 8601::
21
+ Time and date specified by the ISO 8601 standard, for example
22
+ `2005-04-07T22:13:13`. The parser accepts a space instead of the
23
+ `T` character as well.
24
++
25
+NOTE: In addition, the date part is accepted in the following formats:
26
+`YYYY.MM.DD`, `MM/DD/YYYY` and `DD.MM.YYYY`.
Documentation/git-commit-tree.txt
+1
@@ -73,6 +73,7 @@ A commit comment is read from stdin. If a changelog
73
entry is not provided via "<" redirection, 'git-commit-tree' will just wait
74
for one to be entered and terminated with ^D.
75
76
+include::date-formats.txt[]
77
78
Diagnostics
79
-----------
Documentation/git-commit.txt
+2
@@ -220,6 +220,8 @@ specified.
220
these files are also staged for the next commit on top
221
of what have been staged before.
222
223
+:git-commit: 1
224
+include::date-formats.txt[]
225
226
EXAMPLES
227
--------