doc: mention approxidates for git-commit --date
We describe the more strict date formats accepted by GIT_COMMITTER_DATE, etc, but the --date option also allows the looser approxidate formats, as well. Unfortunately we don't have a good or complete reference for this format, but let's at least mention that it _is_ looser, and give a few examples. If we ever write separate, more complete date-format documentation, we should refer to it from here. Based-on-a-patch-by: Utku Gultopu <ugultopu@gmail.com> Signed-off-by: Jeff King <peff@peff.net> Signed-off-by: Junio C Hamano <gitster@pobox.com>
Jeff King committed
Feb 23, 2021 at 15:50 UTC
01168a9d8967c57318f30c6760ecc1c05ea611ae
1 file changed
+7
-4
Documentation/date-formats.txt
+7
-4
@@ -1,10 +1,7 @@
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[]
4
+The `GIT_AUTHOR_DATE` and `GIT_COMMITTER_DATE` environment variables
5
support the following date formats:
6
7
Git internal format::
@@ -26,3 +23,9 @@ ISO 8601::
23
+
24
NOTE: In addition, the date part is accepted in the following formats:
25
`YYYY.MM.DD`, `MM/DD/YYYY` and `DD.MM.YYYY`.
26
+
27
+ifdef::git-commit[]
28
+In addition to recognizing all date formats above, the `--date` option
29
+will also try to make sense of other, more human-centric date formats,
30
+such as relative dates like "yesterday" or "last Friday at noon".
31
+endif::git-commit[]