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 /git-log.html | |
parent | 70d664063d4eb347c0d30071e08a40fbf72dcd34 (diff) | |
download | git-htmldocs-1eb5609b6b3e2908ee747dfe313c24f17334ce26.tar.gz |
Autogenerated HTML docs for v2.6.1-120-g24a00e
Diffstat (limited to 'git-log.html')
-rw-r--r-- | git-log.html | 31 |
1 files changed, 24 insertions, 7 deletions
diff --git a/git-log.html b/git-log.html index deed9e72e..1f20f751a 100644 --- a/git-log.html +++ b/git-log.html @@ -1960,17 +1960,21 @@ being displayed. Examples: "--notes=foo" will show only notes from </p>
</dd>
<dt class="hdlist1">
---date=(relative|local|default|iso|iso-strict|rfc|short|raw)
+--date=<format>
</dt>
<dd>
<p>
Only takes effect for dates shown in human-readable format, such
as when using <code>--pretty</code>. <code>log.date</code> config variable sets a default
- value for the log command’s <code>--date</code> option.
+ value for the log command’s <code>--date</code> option. By default, dates
+ are shown in the original time zone (either committer’s or
+ author’s). If <code>-local</code> is appended to the format (e.g.,
+ <code>iso-local</code>), the user’s local time zone is used instead.
</p>
<div class="paragraph"><p><code>--date=relative</code> shows dates relative to the current time,
-e.g. “2 hours ago”.</p></div>
-<div class="paragraph"><p><code>--date=local</code> shows timestamps in user’s local time zone.</p></div>
+e.g. “2 hours ago”. The <code>-local</code> option cannot be used with
+<code>--raw</code> or <code>--relative</code>.</p></div>
+<div class="paragraph"><p><code>--date=local</code> is an alias for <code>--date=default-local</code>.</p></div>
<div class="paragraph"><p><code>--date=iso</code> (or <code>--date=iso8601</code>) shows timestamps in a ISO 8601-like format.
The differences to the strict ISO 8601 format are:</p></div>
<div class="ulist"><ul>
@@ -1999,9 +2003,22 @@ format, often found in email messages.</p></div> <div class="paragraph"><p><code>--date=format:...</code> feeds the format <code>...</code> to your system <code>strftime</code>.
Use <code>--date=format:%c</code> to show the date in your system locale’s
preferred format. See the <code>strftime</code> manual for a complete list of
-format placeholders.</p></div>
-<div class="paragraph"><p><code>--date=default</code> shows timestamps in the original time zone
-(either committer’s or author’s).</p></div>
+format placeholders. When using <code>-local</code>, the correct syntax is
+<code>--date=format-local:...</code>.</p></div>
+<div class="paragraph"><p><code>--date=default</code> is the default format, and is similar to
+<code>--date=rfc2822</code>, with a few exceptions:</p></div>
+<div class="ulist"><ul>
+<li>
+<p>
+there is no comma after the day-of-week
+</p>
+</li>
+<li>
+<p>
+the time zone is omitted when the local time zone is used
+</p>
+</li>
+</ul></div>
</dd>
<dt class="hdlist1">
--parents
|