{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://raw.githubusercontent.com/api-evangelist/ipgeolocation/refs/heads/main/json-schema/timezone-timezone-schema.json",
  "title": "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": "number",
      "format": "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": "number",
      "description": "Week number of the current year.",
      "example": 17
    },
    "month": {
      "type": "number",
      "description": "Current month number.",
      "example": 4
    },
    "year": {
      "type": "number",
      "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": "number",
      "format": "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."
        }
      }
    }
  }
}