Skip to content

Commit 01168a9

Browse files
peffgitster
authored andcommitted
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 <[email protected]> Signed-off-by: Jeff King <[email protected]> Signed-off-by: Junio C Hamano <[email protected]>
1 parent 59ec224 commit 01168a9

File tree

1 file changed

+7
-4
lines changed

1 file changed

+7
-4
lines changed

Documentation/date-formats.txt

Lines changed: 7 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1,10 +1,7 @@
11
DATE FORMATS
22
------------
33

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
85
support the following date formats:
96

107
Git internal format::
@@ -26,3 +23,9 @@ ISO 8601::
2623
+
2724
NOTE: In addition, the date part is accepted in the following formats:
2825
`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[]

0 commit comments

Comments
 (0)