Time Zone Info API
This API returns active IANA time zone information for any time zone identifier — current UTC offset, daylight saving time status and schedule, and current local time. If you pass a UTC reference time, it converts that time to the local time of the specified zone.
It's useful anywhere you need accurate, up-to-date time zone data without maintaining your own IANA database — scheduling systems, display formatting, or any application that needs to show local time to users in different regions.
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