How to view stash date/timestamp next to stash id?

LazerSharks picture LazerSharks · Jul 28, 2015 · Viewed 8.2k times · Source

Using git stash list shows me the list of stashes with their IDs. Using git stash list --date=local or git stash list --date=relative gives me their times, but I have no idea what their corresponding ID is.

I want to acquire a stash at a certain time.

Answer

torek picture torek · Jul 29, 2015

git stash list simply runs git log with a particular set of options:

list_stash () {
        have_stash || return 0
        git log --format="%gd: %gs" -g --first-parent -m "$@" $ref_stash --
}

The $@ part inserts whatever additional options you've specified (none by default, but --date=relative in this case).1

When you use --date=relative this modifies the output from %gd: instead of a short reflog with an index, you get a short reflog with a relative time stamp:

$ git stash list
stash@{0}: ...
$ git stash list --date=relative
stash@{4 minutes ago}: ...

The solution in this case is to use your own explicit format, rather than just letting --date=relative modify how %gd gets displayed. For instance:

$ git stash list --format='%gd (%cr): %gs'
stash@{0} (4 minutes ago): ...

(%cr inserts the commit's committer time stamp, in relative format—this makes sense once you know that all git stash does is make a couple of commits for you, with the commits being stored on the special stash ref instead of on a branch).


1On reviewing this answer, I note that the --first-parent and -m arguments (literally present in the git stash code) seem redundant at first, because of the -g argument. The -g argument to git log tells it to look only at the reflog, rather than the commit history, in which case, --first-parent means nothing. Meanwhile -m tells git diff to split a merge commit, but we're looking at commit logs, not diffs, so what is this doing here?

The answer is that git log can show a patch, for which it runs git diff, so if you give -p as an argument, the --first-parent -m limits this diff to comparing the commit to which the stash reflog points against its first parent. The stash bag commit to which the reflog entry points is the work-tree commit, whose first parent is the original commit on which the stash-bag hangs. (Its second parent is the index commit and its third parent, if present, is the all or untracked files commit.) So these options are there to make git stash list -p diff the stash's work-tree commit against the commit that was current when the stash itself was made.

This is clever, but quite obscure! :-)