🍿 2 min. read

git is hard, but time travel in git is easy.

Monica Powell

monica dancing - in space?

This article will explain how it's possible to commit code that is dated in the future.

Committing changes in the future

I always (wrongly) assumed that GitHub determined the time a commit was made based on their website's server time. I made this assumption because for certain user actions GitHub uses their server time, for example when a pull request is opened. However, one day I was debugging a calendar issue that only appeared for certain dates. I was able to reproduce and resolve the bug locally by changing my computer time. I then pushed the git branch with my solution up to the remote git repository on GitHub for code review and realized that GitHub commits reflect the date set in the local version of the git repository which is determined by your computer's system time and not their servers.

GitHub, GitLab and BitBucket are git repository hosting services, that provide a centralized place to host remote versions of git repositories. These websites have additional functionality build on top of git to make the software development process more collaborative through things such as code review interfaces and other features that make it more of a social network than just a command line interface.

If you want to intentionally for whatever reason commit something in the future, do you have to manually adjust your computer's time? No, you can simply pass git environment variables to set the date and time.

The following line:

1GIT_AUTHOR_DATE="Wed Mar 27 15:12:30 2019 -0700 GIT_COMMITTER_DATE="Wed Mar 27 15:12:30 2019 -0700”
2git commit -m “future commit”

will date a commit as March 27, 2019 whether the current date is before or after March 27th. If you send in a patch to a project and one of the core members applies the patch, both of you get credit — you as the GIT_AUTHOR, and the core maintainer as the GIT_COMMITTER.

You can rewrite your git history and apply changes to any past commit as well.

This post is based off of a lightning talk that I gave with Women Who Code NYC in March 2019. The slides can be viewed here.

This article was published on March 24, 2019.

Don't be a stranger! 👋🏾

Thanks for reading "git is hard, but time travel in git is easy.". Join my mailing list to be the first to receive my newest web development content, my thoughts on the web and learn about exclusive opportunities.


    I won’t send you spam. Unsubscribe at any time.


    • programator
    • Pritika (Pri) Dasgupta
    • Jesús Macedo 🤘🏻
    • oksanadev