The average enterprise on Netlify ships 140 times per week. Where does your team rank?

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 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 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.