• format
  • date format
  • color

format

[!TIP|label:references:]

• field names
• formattinghttps://git-scm.com/docs/git-for-each-ref/2.21.0#Documentation/git-for-each-ref.txt---formatltformatgt
• git/t/t6300-for-each-ref.sh

• format

• head

• gs

date format

[!TIP] references:

• Specification for syntax of git dates
• strftime
• strftime

format:

• relative
• local
• default
• iso ( or iso8601 )
• rfc ( or rfc2822 )
• short
• raw
• format:%Y-%m-%d %I:%M %p

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
• %% : Percent sign
• %z, %Z : Either the time-zone name or time zone abbreviation, depending on registry settings

$ git for-each-ref --sort=-taggerdate refs/tags \
                   --format='%(committerdate)'
Mon Aug 30 21:50:57 2021 +0800

$ git for-each-ref --sort=-taggerdate refs/tags \
                   --format='%(committerdate:relative)'
9 months ago

$ git for-each-ref --sort=-taggerdate refs/tags \
                   --format='%(committerdate:raw)'
1630331457 +0800

$ git for-each-ref --sort=-taggerdate refs/tags \
                   --format='%(committerdate:iso)'
2021-08-30 21:50:57 +0800

$ git for-each-ref --sort=-taggerdate refs/tags \
                   --format='%(committerdate:rfc)'
Mon, 30 Aug 2021 21:50:57 +0800

$ git for-each-ref --sort=-taggerdate refs/tags \
                   --format='%(committerdate:local)'
Mon Aug 30 21:50:57 2021

$ git for-each-ref --sort=-taggerdate refs/tags \
                   --format='%(committerdate:format:%Y-%m-%d %I:%M %p)'
2021-08-30 09:50 PM

$ git for-each-ref --sort=-taggerdate refs/tags \
                   --format='%(committerdate:format:%Y-%m-%d %H:%M:%S)'
2021-08-30 21:50:57

color

[!TIP|label:usage:]

• %(color:<color_name>)
• %(color:reset)

$ git for-each-ref --sort=-taggerdate refs/tags \
                   --format='%(color:yellow)%(committerdate:iso)%(color:reset)' \
                   --color=always
2021-08-30 21:50:57 +0800

$ git for-each-ref --sort=-taggerdate refs/tags \
                   --format='%(color:blue)%(committerdate:iso)%(color:reset)' \
                   --color=always
2021-08-30 21:50:57 +0800

condition

[!TIP|label:references:]

• %(if)...%(then)...%(else)...%(end)
• %(align:<number>,left) ... %(end)

$ git for-each-ref --sort=-taggerdate refs/tags \
                   --format='%(if)%(committerdate)%(then)%(committerdate:format:%Y-%m-%d %I:%M %p)%(else)%(taggerdate:format:%Y-%m-%d %I:%M %p)%(end)'
2021-08-30 09:50 PM

$ git for-each-ref --sort=-taggerdate refs/tags \
                   --format='%(align:left,50)[%(objecttype) : %(refname:short)]%(end) (%(committerdate:format:%Y-%m-%d %H:%M)) <%(committername)>' \
                   --color \
                   --count=10
[commit : sandbox/marslo/tag-1]              (2021-08-30 21:50) <marslo>