diff options
author | Junio C Hamano <gitster@pobox.com> | 2015-10-05 13:39:53 -0700 |
---|---|---|
committer | Junio C Hamano <gitster@pobox.com> | 2015-10-05 13:39:53 -0700 |
commit | 1eb5609b6b3e2908ee747dfe313c24f17334ce26 (patch) | |
tree | 7399ab13ecb59275ff9caa0624441831a5b0f8de /rev-list-options.txt | |
parent | 70d664063d4eb347c0d30071e08a40fbf72dcd34 (diff) | |
download | git-htmldocs-1eb5609b6b3e2908ee747dfe313c24f17334ce26.tar.gz |
Autogenerated HTML docs for v2.6.1-120-g24a00e
Diffstat (limited to 'rev-list-options.txt')
-rw-r--r-- | rev-list-options.txt | 23 |
1 files changed, 16 insertions, 7 deletions
diff --git a/rev-list-options.txt b/rev-list-options.txt index f1c52208f..4f009d442 100644 --- a/rev-list-options.txt +++ b/rev-list-options.txt @@ -701,15 +701,19 @@ include::pretty-options.txt[] --relative-date:: Synonym for `--date=relative`. ---date=(relative|local|default|iso|iso-strict|rfc|short|raw):: +--date=<format>:: Only takes effect for dates shown in human-readable format, such as when using `--pretty`. `log.date` config variable sets a default - value for the log command's `--date` option. + value for the log command's `--date` option. By default, dates + are shown in the original time zone (either committer's or + author's). If `-local` is appended to the format (e.g., + `iso-local`), the user's local time zone is used instead. + `--date=relative` shows dates relative to the current time, -e.g. ``2 hours ago''. +e.g. ``2 hours ago''. The `-local` option cannot be used with +`--raw` or `--relative`. + -`--date=local` shows timestamps in user's local time zone. +`--date=local` is an alias for `--date=default-local`. + `--date=iso` (or `--date=iso8601`) shows timestamps in a ISO 8601-like format. The differences to the strict ISO 8601 format are: @@ -732,10 +736,15 @@ format, often found in email messages. `--date=format:...` feeds the format `...` to your system `strftime`. Use `--date=format:%c` to show the date in your system locale's preferred format. See the `strftime` manual for a complete list of -format placeholders. +format placeholders. When using `-local`, the correct syntax is +`--date=format-local:...`. + -`--date=default` shows timestamps in the original time zone -(either committer's or author's). +`--date=default` is the default format, and is similar to +`--date=rfc2822`, with a few exceptions: + + - there is no comma after the day-of-week + + - the time zone is omitted when the local time zone is used ifdef::git-rev-list[] --header:: |