Timezone is a JSON Structure definition published by IPGeolocation.io, describing 26 properties. It conforms to the https://json-structure.org/meta/core/v0/# meta-schema.
{
"$schema": "https://json-structure.org/meta/core/v0/#",
"$id": "https://raw.githubusercontent.com/api-evangelist/ipgeolocation/refs/heads/main/json-structure/timezone-timezone-structure.json",
"name": "Timezone",
"description": "Detailed timezone information for the requested location or identifier.\n\nContains timezone metadata such as UTC offset, daylight saving time (DST)\nstatus, formatted timestamps, and DST transition information.\n",
"type": "object",
"properties": {
"name": {
"type": "string",
"description": "IANA timezone identifier for the location.",
"example": "America/Los_Angeles"
},
"offset": {
"format": "float",
"description": "Standard timezone offset from UTC in hours.",
"example": -8
},
"offset_with_dst": {
"format": "float",
"description": "Timezone offset from UTC including daylight saving time.",
"example": -7
},
"date": {
"type": "string",
"description": "Current date in `YYYY-MM-DD` format.",
"example": "2025-04-24"
},
"date_time": {
"type": "string",
"description": "Current date and time in `YYYY-MM-DD HH:mm:ss` format.",
"example": "2025-04-24 11:30:12"
},
"date_time_txt": {
"type": "string",
"description": "Human-readable date and time string.",
"example": "Thursday, April 24, 2025 11:30:12"
},
"date_time_wti": {
"type": "string",
"description": "Date and time with timezone information.",
"example": "Thu, 24 Apr 2025 11:30:12 -0700"
},
"date_time_ymd": {
"type": "string",
"description": "ISO-8601 formatted date and time with timezone offset.",
"example": "2025-04-24T11:30:12-0700"
},
"current_time_unix": {
"type": "float",
"description": "Unix timestamp representing the current date and time.",
"example": 1745519412.353
},
"time_24": {
"type": "string",
"description": "Current local time in 24-hour format.",
"example": "11:30:12"
},
"time_12": {
"type": "string",
"description": "Current local time in 12-hour format.",
"example": "11:30:12 AM"
},
"week": {
"type": "double",
"description": "Week number of the current year.",
"example": 17
},
"month": {
"type": "double",
"description": "Current month number.",
"example": 4
},
"year": {
"type": "double",
"description": "Four-digit year.",
"example": 2025
},
"year_abbr": {
"type": "string",
"description": "Two-digit abbreviated year.",
"example": "25"
},
"current_tz_abbreviation": {
"type": "string",
"description": "Abbreviation of the timezone currently in effect.",
"example": "AEST"
},
"current_tz_full_name": {
"type": "string",
"description": "Full name of the timezone currently in effect.",
"example": "Australian Eastern Standard Time"
},
"standard_tz_abbreviation": {
"type": "string",
"description": "Standard (non-DST) timezone abbreviation.",
"example": "AEST"
},
"standard_tz_full_name": {
"type": "string",
"description": "Full name of the standard timezone.",
"example": "Australian Eastern Standard Time"
},
"is_dst": {
"type": "boolean",
"description": "Indicates whether daylight saving time is currently active."
},
"dst_savings": {
"type": "float",
"description": "Number of hours added during daylight saving time."
},
"dst_exists": {
"type": "boolean",
"description": "Indicates whether the region observes daylight saving time."
},
"dst_tz_abbreviation": {
"type": "string",
"description": "Abbreviation used during daylight saving time.",
"example": "PDT"
},
"dst_tz_full_name": {
"type": "string",
"description": "Full name used during daylight saving time.",
"example": "Pacific Daylight Time"
},
"dst_start": {
"type": "object",
"description": "Represents a daylight saving time transition event including the\nmoment when DST begins or ends.\n",
"properties": {
"utc_time": {
"type": "string",
"description": "UTC timestamp when the DST transition occurs.",
"example": "2025-03-09 TIME 10"
},
"duration": {
"type": "string",
"description": "Time change applied during the transition.",
"example": "+1H"
},
"gap": {
"type": "boolean",
"description": "Indicates whether an hour is skipped during the transition."
},
"date_time_after": {
"type": "string",
"description": "Local date and time immediately after the DST change.",
"example": "2025-03-09 TIME 03"
},
"date_time_before": {
"type": "string",
"description": "Local date and time immediately before the DST change.",
"example": "2025-03-09 TIME 02"
},
"overlap": {
"type": "boolean",
"description": "Indicates whether clock time overlaps during the transition."
}
}
},
"dst_end": {
"type": "object",
"description": "Represents a daylight saving time transition event including the\nmoment when DST begins or ends.\n",
"properties": {
"utc_time": {
"type": "string",
"description": "UTC timestamp when the DST transition occurs.",
"example": "2025-03-09 TIME 10"
},
"duration": {
"type": "string",
"description": "Time change applied during the transition.",
"example": "+1H"
},
"gap": {
"type": "boolean",
"description": "Indicates whether an hour is skipped during the transition."
},
"date_time_after": {
"type": "string",
"description": "Local date and time immediately after the DST change.",
"example": "2025-03-09 TIME 03"
},
"date_time_before": {
"type": "string",
"description": "Local date and time immediately before the DST change.",
"example": "2025-03-09 TIME 02"
},
"overlap": {
"type": "boolean",
"description": "Indicates whether clock time overlaps during the transition."
}
}
}
}
}