Time Zone Info API
Our Time Zone Info API is a potent yet straightforward tool that provides in-depth active IANA time zone information, including daylight saving time adjustments if relevant. Additionally, it returns the current local time by default, and if given a UTC reference time, it automatically performs time zone conversion for you.
GET
https://api-bdc.net/data/timezone-infoParameters
| Parameter | Type | Required | Description |
|---|---|---|---|
timeZoneId | string | Optional | Time Zone name in IANA format, for example 'Australia/Sydney' |
utcReference | integer (int64) | Optional | UTC reference in Unix Time Seconds format. When omitted or invalid, the current time is assumed |
key | string | Optional | Your API key |
Responses
200OK
Sample Request
https://api-bdc.net/data/timezone-info?timeZoneId=Australia/Sydney&key=[YOUR API KEY]Sample Response
JSON View
Response Schema
ianaTimeIdstringThe unique identifier of the time zone from the IANA Time Zone Database (e.g., "America/New_York").
displayNamestringThe user-friendly display name for the time zone (e.g., "(UTC-05:00) Eastern Time (US & Canada)").
effectiveTimeZoneFullstringThe full name of the effective time zone, adjusted for daylight saving (e.g., "Eastern Daylight Time").
effectiveTimeZoneShortstringThe abbreviated name of the effective time zone, adjusted for daylight saving (e.g., "EDT").
utcOffsetSecondsintegerThe effective offset from UTC in seconds, adjusted for daylight saving time.
utcOffsetstringThe effective offset from UTC, formatted as a string and adjusted for daylight saving time.
isDaylightSavingTimebooleanA boolean value indicating whether daylight saving time is currently in effect.
localTimestringThe current local time in the specified time zone, formatted in ISO 8601 "O" format.
utcTimestringThe corresponding UTC time, formatted in ISO 8601 "O" format. This value is omitted if the 'utcReference' parameter was not supplied or was invalid.
400Bad request
Sample Response
JSON View
403Access denied, or your quota limit has exceeded
Sample Response
JSON View
404Found no valid entry for the request
Sample Response
JSON View
500An error has occurred and did not complete your request. Please try again
Sample Response
JSON View