summaryrefslogtreecommitdiffstats
path: root/git-log.html
diff options
context:
space:
mode:
authorJunio C Hamano <gitster@pobox.com>2015-10-05 13:39:53 -0700
committerJunio C Hamano <gitster@pobox.com>2015-10-05 13:39:53 -0700
commit1eb5609b6b3e2908ee747dfe313c24f17334ce26 (patch)
tree7399ab13ecb59275ff9caa0624441831a5b0f8de /git-log.html
parent70d664063d4eb347c0d30071e08a40fbf72dcd34 (diff)
downloadgit-htmldocs-1eb5609b6b3e2908ee747dfe313c24f17334ce26.tar.gz
Autogenerated HTML docs for v2.6.1-120-g24a00e
Diffstat (limited to 'git-log.html')
-rw-r--r--git-log.html31
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=&lt;format&gt;
</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&#8217;s <code>--date</code> option.
+ value for the log command&#8217;s <code>--date</code> option. By default, dates
+ are shown in the original time zone (either committer&#8217;s or
+ author&#8217;s). If <code>-local</code> is appended to the format (e.g.,
+ <code>iso-local</code>), the user&#8217;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. &#8220;2 hours ago&#8221;.</p></div>
-<div class="paragraph"><p><code>--date=local</code> shows timestamps in user&#8217;s local time zone.</p></div>
+e.g. &#8220;2 hours ago&#8221;. 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&#8217;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&#8217;s or author&#8217;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