如何更改 Git 日志日期格式

Question

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

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

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

Answer 1

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

--date=format:'%Y-%m-%d %H:%M:%S'       # committer's timezone
--date=format-local:'%Y-%m-%d %H:%M:%S' # current user's timezone

格式输出类似 2016-01-13 11:32:13 的内容。

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

在完整的命令中，它会类似于：

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

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

在我搜索相关文档时，我发现 对 Git 本身的提交 表明格式是直接馈送到strftime。查找 strftime（此处 或 此处）我发现的占位符与列出的占位符匹配。

占位符包括：

%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

Answer 2

其他的是（来自 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 

Or，以影响此帐户的所有 git 使用情况

git config --global log.date iso

Answer 3

经过很长时间寻找一种方法来获取git log以YYYY-MM-DD格式输出日期，以less工作的方式code>，我想出了以下格式：

%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 4

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

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

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

Answer 5

您可以使用字段截断选项来避免出现太多 %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=，因此如果您想要 YYYY-MM-DD< /code>，你可以这样做并完全避免 %< 和 %x08：

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

---

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

Answer 6

2014 ：注意“date=iso”格式：它不完全 ISO 8601。
请参阅 466fb67” /bbolli" rel="nofollow noreferrer">击败博利(bbolli)，对于 Git 2.2.0（2014 年 11 月）来说

非常漂亮：提供严格的 ISO 8601 日期格式

由于微小的差异，Git 的“ISO”日期格式并不真正符合 ISO 8601 标准，并且它无法被仅支持 ISO 8601 的解析器（例如 XML 工具链的解析器）解析。

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

• 用空格代替 T 日期/时间分隔符
• 时间和时区之间的空格
• 时区的小时和分钟之间没有冒号

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

请参阅 此帖子进行讨论。

---

对于 Git 2.45（2024 年第 2 季度），批次 10，日期的输出格式为“< code>iso-strict”已被调整以显示祖鲁时区时间，后缀为“Z”，而不是“+00:00”。

请参阅 提交 69e2bee（2024 年 3 月 13 日），作者：击败 Bolli (bbolli)。
^{（由 Junio C Hamano -- gitster -- 合并于 提交 1f49f75，2024 年 3 月 21 日）}

日期：制作“iso -strict" 符合 UTC 时区

^{报告人：Michael Osipov
签署人：Beat Bolli}

ISO 8601-1:2020-12 规定零时区偏移必须用“Z”后缀表示，而不是数字“+00:00” .
将相应的特殊情况添加到 show_date() 和一个新测试。

更改脚本可能依赖的既定输出格式始终是有问题的，但在这里我们选择更严格地遵守已发布的标准。

2016-06-15T14:13:20Z

Answer 7

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

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

Answer 8

我需要特殊格式的日期。

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

当输出发送到寻呼机或终端时，可以使用“--date=auto”来使用这种新格式，否则使用默认格式。

请参阅提交110a6a1，提交 b841d4f（2019 年 1 月 29 日），以及 提交 038a878, 提交 2fd7c22（2019 年 1 月 21 日），作者：斯蒂芬·P·史密斯(``)。
请参阅 提交 acdd377（2019 年 1 月 18 日），作者：莱纳斯·托瓦兹（托瓦尔兹）。
^{（由 Junio C Hamano -- gitster -- 合并于 提交ecbe1be，2019 年 2 月 7 日）}

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

以类似于人们在其他上下文中书写日期的格式显示日期和时间信息。
如果未指定年份，读者推断给出的日期是当年。

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

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

添加人类日期格式测试。

使用人类时，根据参考日期和本地计算机日期之间的时间差，多个字段会被抑制。

• 如果差异小于一年，年份字段将被隐藏。
• 如果时间少于一天；月份和年份是
  压制。

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 关键字，该关键字可在配置文件中用作指定 human 格式的替代方法。删除“auto”会清理“ human”格式界面。

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

git config --add log.date auto: human

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

---

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

请参阅提交47b27c9，提交 29f4332（2019 年 9 月 12 日），作者：斯蒂芬·P·史密斯(``)。
^{（由 Junio C Hamano -- gitster -- 合并于 提交36d2fca，2019 年 10 月 7 日）}

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

提交b841d4f（添加 human 格式进行测试-工具，2019-01-28，Git v2.21.0-rc0）添加了 get_time() 函数，允许环境中的 $GIT_TEST_DATE_NOW 覆盖当前时间。
因此我们不再需要在 cmd__date() 中解释该变量。

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

---

使用 Git 2.32（2021 年第 2 季度），“git日志--format=..."^(man) 占位符学习 %ah/%ch 占位符来请求 --date =人类输出。

请参阅 提交 b722d45（2021 年 4 月 25 日），作者：胡哲宁（替代方案）。
^{（由 Junio C Hamano -- gitster -- 合并于 提交f16a466，2021 年 5 月 7 日）}

pretty：提供人类日期格式

^{签字人：胡哲宁}

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

pretty-formats 现在包含在其 手册页：

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

漂亮-格式现在包含在其手册页：

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

Answer 9

Git 2.7（2015 年第 4 季度）将引入 -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 一起使用。 参考。

您现在可以使用请求任何日期格式当地时区。
请参阅

• 提交99264e9，
• 提交 db7bae2,
• 提交 dc6d782,
• 提交 f3c1ba5,
• 提交 f95cecf,
• 提交 4b1c5e1,
• 提交 8f50d26,
• 提交 78a8441,
• 提交 2df4e29（2015 年 9 月 3 日），作者：约翰保持（johnkeeping）。

请参阅提交add00ba，提交 547ed71（2015 年 9 月 3 日），作者：杰夫·金（peff）。
^{（由 Junio C Hamano -- gitster -- 合并于 提交7b09c45，2015 年 10 月 5 日）}

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

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

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

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




Answer 10

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

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

--format="%ai"

Answer 11

使用 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 12

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]"