Time Zone Info API

Introduction

Dealing with time zones in your applications can be challenging and at times confusing. You might need to build an entire module dedicated to time zone conversion and assignment based on location information. Daylight saving complicates the matter.

Hence in order to ease your development cycle and help you focus on the features that matter to you, this API does all the hard work for you.

Our Time Zone Info API returns detailed active IANA time zone information including daylight saving adjustments if applicable. It will also return the current local time by default, or if supplied with a UTC reference time, it will automatically perform time zone conversion for you.

Example Response

The response is only available in JSON format. The below response should be expected for the following request:



Awaiting request submission...

API Pricing

  1. Monthly Subscription
    FREE 10,000 queries/month
    Additional 10,000 queries US$1.00/month
  2. Annual Subscription
    FREE 10,000 queries/month
    Additional 10,000 queries US$0.80/month

Request Format

NEW! Payload compression is supported, simply add Accept-Encoding: gzip header.
Use the form below to try out this API.

Parameter Your Input Value Description
timeZoneId Time Zone name in IANA format
utcReference UTC time reference in Unix Time Seconds format. When omitted or invalid, the current time is assumed
key Your API key

Don't have an API Key? Click here to register and get your free API Key

If you already have a BigDataCloud account, to automatically fill this field with your Api Key.



Response

Awaiting request submission...

Response Format

Field

Data type

Description

ianaTimeId

string

Time Zone name in IANA format

displayName

string

Display name

effectiveTimeZoneFull

string

Effective time zone full name (adjusted to the daylight saving status)

effectiveTimeZoneShort

string

Effective time zone short name (adjusted to the daylight saving status)

UtcOffsetSeconds

32 bit integer

Effective offset from UTC time in seconds

UtcOffset

string

Effective offset from UTC time

isDaylightSavingTime

boolean

Indicates if the daylight saving is on

localTime

string

Local time in ISO 8601 format

utcTime

string

UTC time in ISO 8601 format. Omitted when utcReference parameter was not supplied, or invalid

Related APIs