Merge branch 'jc/branch-parseopt-fix'
[git/debian.git] / Documentation / date-formats.txt
blob67645cae64f3b22c7ab518667a93c7caebf9cd54
1 DATE FORMATS
2 ------------
4 The `GIT_AUTHOR_DATE` and `GIT_COMMITTER_DATE` environment variables
5 support the following date formats:
7 Git internal format::
8         It is `<unix-timestamp> <time-zone-offset>`, where
9         `<unix-timestamp>` is the number of seconds since the UNIX epoch.
10         `<time-zone-offset>` is a positive or negative offset from UTC.
11         For example CET (which is 1 hour ahead of UTC) is `+0100`.
13 RFC 2822::
14         The standard email format as described by RFC 2822, for example
15         `Thu, 07 Apr 2005 22:13:13 +0200`.
17 ISO 8601::
18         Time and date specified by the ISO 8601 standard, for example
19         `2005-04-07T22:13:13`. The parser accepts a space instead of the
20         `T` character as well. Fractional parts of a second will be ignored,
21         for example `2005-04-07T22:13:13.019` will be treated as
22         `2005-04-07T22:13:13`.
24 NOTE: In addition, the date part is accepted in the following formats:
25 `YYYY.MM.DD`, `MM/DD/YYYY` and `DD.MM.YYYY`.
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[]