Migrate to Netlify Today

Netlify announces the next evolution of Gatsby Cloud. Learn more

ContactSign Up
Community Plugin
View plugin on GitHub


Similar to the build in buildTime query, but provides the option to set the timezone for the build.

It uses Moment Timezone for the timezone conversion.


npm install --save gatsby-plugin-buildtime-timezone

How to use

// In your gatsby-config.js
plugins: [
    resolve: 'gatsby-plugin-buildtime-timezone',
    options: {
      tz: 'Pacific/Auckland',
      format: 'ddd, DD MMM YYYY hh:mm A',


  • tz accepts Moment Timezone method moment.tz() params.

    Most common use would be passing the timezone name as a sting like this.

    tz: 'Europe/Zagreb'
    tz: 'GMT'
  • format accepts Moment.js method moment().format() params.

    format: 'dddd, MMMM Do YYYY, h:mm:ss a' // "Sunday, February 14th 2010, 3:25:50 pm"
    format: 'ddd, DD MMM YYYY hh:mm A zz' // "Thu, 19 Apr 2018 08:39 AM Thu, 19 Apr 2018 08:39 AM NZ"

Timezone names

Here is a list of all the moment timezone names that moment.tz.names() will return as of version 0.5.15. Any of these can be used to pass the tz option.

How to query

A sample GraphQL query:

  site {
© 2023 Gatsby, Inc.