如何更改 Git 日志日期格式

Question

我正在尝试在 Git 中显示最后一次提交，但我需要特殊格式的日期。

我知道日志漂亮格式%ad 尊重--date 格式，但我能找到的唯一--date 格式是“短”。我想知道其他的，以及我是否可以创建一个自定义的，例如：

git -n 1 --date=**YYMMDDHHmm** --pretty=format:"Last committed item in this release was by %%an, %%aD, message: %%s(%%h)[%%d]"

Answer 1

我需要特殊格式的日期。

在 Git 2.21（2019 年第一季度）中，引入了一种新的日期格式“--date=human”，它根据时间与当前时间的距离来改变其输出强>。

"--date=auto" 可用于在输出到寻呼机或终端时使用这种新格式，否则使用默认格式。

请参阅commit 110a6a1、commit b841d4f（2019 年 1 月 29 日）和 commit 038a878、commit 2fd7c22（2019 年 1 月 21 日）Stephen P. Smith (``)。
请参阅 Linus Torvalds (torvalds) 的 commit acdd377（2019 年 1 月 18 日）。
^{（由 Junio C Hamano -- gitster -- 合并于 commit ecbe1be，2019 年 2 月 7 日）}

添加“人类”日期格式文档

以类似于人们在其他情况下书写日期的格式显示日期和时间信息。
If the year isn't specified then, the reader infers the date is given is in the current year。

通过不显示冗余信息，读者可以专注于不同的信息。
该补丁根据在执行命令时运行git 命令的机器上的日期推断的信息报告相对日期。

虽然格式通过删除推断信息对人类更有用，但没有什么使它真正成为人类。
如果尚未实现“relative”日期格式，则使用“relative”是合适的。

添加human日期格式测试。

使用human 时，根据参考日期和本地计算机日期之间的时间差，会隐藏多个字段。

• 如果差值小于一年，则不显示年份字段。
• 如果时间少于一天；月份和年份是 被压制。

check_date_format_human 18000       "5 hours ago"       #  5 hours ago
check_date_format_human 432000      "Tue Aug 25 19:20"  #  5 days ago
check_date_format_human 1728000     "Mon Aug 10 19:20"  #  3 weeks ago
check_date_format_human 13000000    "Thu Apr 2 08:13"   #  5 months ago
check_date_format_human 31449600    "Aug 31 2008"       # 12 months ago
check_date_format_human 37500000    "Jun 22 2008"       #  1 year, 2 months ago
check_date_format_human 55188000    "Dec 1 2007"        #  1 year, 9 months ago
check_date_format_human 630000000   "Sep 13 1989"       # 20 years ago

将建议的“auto”模式替换为“auto:”

除了添加“human”格式外，补丁还添加了auto 关键字，可在配置文件中用作指定人工格式的替代方式。删除“auto”会清理“human”格式界面。

添加了在使用 auto:foo 语法使用寻呼机时指定模式“foo”的功能。
因此，如果我们使用寻呼机，“auto:human”日期模式默认为human。
所以你可以这样做：

git config --add log.date auto:human

并且您的“git log”命令将显示人类可读的格式，除非 你正在编写脚本。

---

Git 2.24（2019 年第四季度）简化了代码。

参见commit 47b27c9、commit 29f4332（2019 年 9 月 12 日）Stephen P. Smith (``)。
^{（由 Junio C Hamano -- gitster -- 合并到 commit 36d2fca，2019 年 10 月 7 日）}

停止将“现在”传递给日期代码

Commit b841d4f (Add human format to test-tool, 2019-01-28, Git v2.21.0-rc0) 添加了get_time() 函数，允许环境中的$GIT_TEST_DATE_NOW 覆盖当前时间.
所以我们不再需要在cmd__date() 中解释那个变量。

因此，我们可以停止向下传递“now”参数 日期函数，因为没有人使用它们。
请注意，我们确实需要确保所有先前使用“now”参数的调用者都正确使用了get_time()。

---

在 Git 2.32（2021 年第二季度）中，“git log --format=...”^(man) 占位符学习了 %ah/%ch 占位符来请求 --date=human 输出。

参见 ZheNing Hu (adlternative) 的 commit b722d45（2021 年 4 月 25 日）。
^{（由 Junio C Hamano -- gitster -- 合并到 commit f16a466，2021 年 5 月 7 日）}

pretty: 提供人类日期格式

^{签字人：胡哲宁}

添加占位符 %ah 和 %ch 以格式化作者日期和提交者日期，就像 --date=human 所做的那样，提供更多人性化的日期输出。

pretty-formats 现在包含在其man page 中：

'%ah':: 作者日期，人类风格（如--date=human 选项 git rev-list)

pretty-formats 现在包含在其man page 中：

'%ch':: 提交者日期，人类风格（如--date=human 选项 git rev-list)

Answer 2

我需要同样的东西，发现以下对我有用：

git log -n1 --pretty='format:%cd' --date=format:'%Y-%m-%d %H:%M:%S'

--date=format 格式化日期输出，--pretty 告诉打印什么。

Answer 3

除了--date=(relative|local|default|iso|iso-strict|rfc|short|raw)，正如其他人提到的，您还可以使用自定义日志日期格式

--date=format:'%Y-%m-%d %H:%M:%S'

这会输出类似2016-01-13 11:32:13 的内容。

注意：如果您查看链接到下面的提交，我相信您至少需要 Git v2.6.0-rc0 才能使其工作。

在一个完整的命令中，它会是这样的：

git config --global alias.lg "log --graph --decorate 
-30 --all --date-order --date=format:'%Y-%m-%d %H:%M:%S' 
--pretty=format:'%C(cyan)%h%Creset %C(black bold)%ad%Creset%C(auto)%d %s'" 

我无法在任何地方的文档中找到它（如果有人知道在哪里可以找到它，请发表评论）所以我最初通过反复试验找到了占位符。

在搜索这方面的文档时，我发现了a commit to Git itself，这表明该格式直接提供给strftime。查找 strftime（here 或 here）我找到的占位符与列出的占位符匹配。

占位符包括：

%a      Abbreviated weekday name
%A      Full weekday name
%b      Abbreviated month name
%B      Full month name
%c      Date and time representation appropriate for locale
%d      Day of month as decimal number (01 – 31)
%H      Hour in 24-hour format (00 – 23)
%I      Hour in 12-hour format (01 – 12)
%j      Day of year as decimal number (001 – 366)
%m      Month as decimal number (01 – 12)
%M      Minute as decimal number (00 – 59)
%p      Current locale's A.M./P.M. indicator for 12-hour clock
%S      Second as decimal number (00 – 59)
%U      Week of year as decimal number, with Sunday as first day of week (00 – 53)
%w      Weekday as decimal number (0 – 6; Sunday is 0)
%W      Week of year as decimal number, with Monday as first day of week (00 – 53)
%x      Date representation for current locale
%X      Time representation for current locale
%y      Year without century, as decimal number (00 – 99)
%Y      Year with century, as decimal number
%z, %Z  Either the time-zone name or time zone abbreviation, depending on registry settings
%%      Percent sign

在一个完整的命令中，它会是这样的

git config --global alias.lg "log --graph --decorate -30 --all --date-order --date=format:'%Y-%m-%d %H:%M:%S' --pretty=format:'%C(cyan)%h%Creset %C(black bold)%ad%Creset%C(auto)%d %s'" 

Answer 4

使用 Bash 和 date 命令将类似于 ISO 的格式转换为您想要的格式。我想要一个org-mode 日期格式（和列表项），所以我这样做了：

echo + [$(date -d "$(git log --pretty=format:%ai -1)" +"%Y-%m-%d %a %H:%M")] \
    $(git log --pretty=format:"%h %s" --abbrev=12 -1)

结果例如：

+ [2015-09-13 Sun 22:44] 2b0ad02e6cec Merge pull request #72 from 3b/bug-1474631

Answer 5

%ai 的格式选项是我想要的：

%ai：作者日期，类似 ISO 8601 的格式

--format="%ai"

Answer 6

其他的是（来自git help log）：

--date=(relative|local|default|iso|rfc|short|raw)
  Only takes effect for dates shown in human-readable format,
  such as when using "--pretty".  log.date config variable
  sets a default value for log command’s --date option.

--date=relative shows dates relative to the current time, e.g. "2 hours ago".

--date=local shows timestamps in user’s local timezone.

--date=iso (or --date=iso8601) shows timestamps in ISO 8601 format.

--date=rfc (or --date=rfc2822) shows timestamps in RFC 2822 format,
  often found in E-mail messages.

--date=short shows only date but not time, in YYYY-MM-DD format.

--date=raw shows the date in the internal raw git format %s %z format.

--date=default shows timestamps in the original timezone
  (either committer’s or author’s).

据我所知，没有创建自定义格式的内置方法，但您可以做一些 shell 魔术。

timestamp=`git log -n1 --format="%at"`
my_date=`perl -e "print scalar localtime ($timestamp)"`
git log -n1 --pretty=format:"Blah-blah $my_date"

这里的第一步为您获取毫秒时间戳。您可以根据需要更改第二行以格式化该时间戳。此示例为您提供类似于 --date=local 的内容，但有一个填充日。

---

如果您想要永久效果而不需要每次都输入，请尝试

git config log.date iso 

或者，为了影响您使用此帐户使用的所有 git

git config --global log.date iso

Answer 7

您可以使用字段截断选项来避免太多%x08 字符。例如：

git log --pretty='format:%h %s%n\t%<(12,trunc)%ci%x08%x08, %an <%ae>'

相当于：

git log --pretty='format:%h %s%n\t%ci%x08%x08%x08%x08%x08%x08%x08%x08%x08%x08%x08%x08%x08%x08%x08, %an <%ae>'

而且眼睛更舒服。

更好的是，对于这个特定的示例，使用 %cd 将尊重 --date=<format>，所以如果你想要 YYYY-MM-DD，你可以这样做并完全避免 %< 和 %x08：

git log --date=short --pretty='format:%h %s%n\t%cd, %an <%ae>'

---

我只是注意到这与原始帖子相比有点循环，但我会留下它，以防其他人使用与我相同的搜索参数到达这里。

Answer 8

在寻找一种方法让git log 以YYYY-MM-DD 格式输出日期以在less 中工作后，我想出了以下格式：

%ad%x08%x08%x08%x08%x08%x08%x08%x08%x08%x08%x08%x08%x08%x08

连同开关--date=iso。

这将以 ISO 格式（长格式）打印日期，然后打印 14 倍的退格字符 (0x08)，这在我的终端中有效地删除了 YYYY-MM-DD 部分之后的所有内容。例如：

git log --date=iso --pretty=format:'%ad%x08%x08%x08%x08%x08%x08%x08%x08%x08%x08%x08%x08%x08%x08%aN %s'

这给出了类似的东西：

2013-05-24 bruno This is the message of the latest commit.
2013-05-22 bruno This is an older commit.
...

我所做的是创建一个名为 l 的别名，并对上述格式进行了一些调整。它在左侧显示提交图，然后是提交的哈希，然后是日期、短名称、引用名称和主题。别名如下（在~/.gitconfig中）：

[alias]
        l = log --date-order --date=iso --graph --full-history --all --pretty=format:'%x08%x09%C(red)%h %C(cyan)%ad%x08%x08%x08%x08%x08%x08%x08%x08%x08%x08%x08%x08%x08%x08%x08 %C(bold blue)%aN%C(reset)%C(bold yellow)%d %C(reset)%s'

Answer 9

Git 2.7（2015 年第四季度）将引入 -local 作为指令。
这意味着，除了：

--date=(relative|local|default|iso|iso-strict|rfc|short|raw)

您还将拥有：

--date=(default-local|iso-local|iso-strict-local|rfc-local|short-local)

-local 后缀不能与raw 或relative 一起使用。 Reference.

您现在可以要求使用当地时区的任何日期格式。 见

• commit 99264e9,
• commit db7bae2,
• commit dc6d782,
• commit f3c1ba5,
• commit f95cecf,
• commit 4b1c5e1,
• commit 8f50d26,
• commit 78a8441,
• commit 2df4e29（2015 年 9 月 3 日）John Keeping (johnkeeping)。

参见commit add00ba、commit 547ed71（2015 年 9 月 3 日）Jeff King (peff)。
^{（由 Junio C Hamano -- gitster -- 合并到 commit 7b09c45，2015 年 10 月 5 日）}

特别是，上面的最后一个（提交 add00ba）提到：

date：使“local”与日期格式正交：

我们的大多数“--date”模式都与日期格式有关：我们显示哪些项目以及以什么顺序显示。
但是“--date=local”有点古怪。这意味着“以正常格式显示日期，但使用当地时区”。
我们使用的时区与实际格式正交，我们没有理由不能拥有“本地化 iso8601”等。

此补丁将“local”布尔字段添加到“struct date_mode”，并从date_mode_type 枚举中删除DATE_LOCAL 元素（现在只是DATE_NORMAL 加上local=1）。
用户可以通过将“-local”添加到任何日期模式（例如，“iso-local”）来访问新功能，并且我们保留“local”作为“default-local”的别名以实现向后兼容性。

Answer 10

注意“date=iso”格式：它不是完全正确ISO 8601。
对于 Git 2.2.0（2014 年 11 月），请参阅来自 Beat Bolli (bbolli) 的提交“466fb67”

pretty：提供严格的 ISO 8601 日期格式

Git 的“ISO”日期格式由于细微的差异并不真正符合 ISO 8601 标准，并且无法由仅限 ISO 8601 的解析器解析，例如XML 工具链的那些。

“--date=iso”的输出在以下方面偏离 ISO 8601：

• 一个空格而不是T 日期/时间分隔符
• 时间和时区之间的空间
• 时区的小时和分钟之间没有冒号

添加严格的 ISO 8601 日期格式以显示提交者和作者日期。
使用“%aI”和“%cI”格式说明符并添加“--date=iso-strict”或“--date=iso8601-strict”日期格式名称。

请参阅this thread 进行讨论。

Answer 11

git log -n1 --format="Last committed item in this release was by %an, `git log -n1 --format=%at | awk '{print strftime("%y%m%d%H%M",$1)}'`, message: %s (%h) [%d]"

Answer 12

date -d @$(git log -n1 --format="%at") +%Y%m%d%H%M

请注意，如果这对您的用例很重要，这将转换为您的本地时区。