IPGeolocation.io · Schema

Timezone

Detailed timezone information for the requested location or identifier. Contains timezone metadata such as UTC offset, daylight saving time (DST) status, formatted timestamps, and DST transition information.

GeocodingIP GeolocationIP IntelligenceIP SecurityASN LookupAbuse ContactTimezoneAstronomyUser AgentThreat IntelligencePublic APIs

Properties

Name	Type	Description
name	string	IANA timezone identifier for the location.
offset	object	Standard timezone offset from UTC in hours.
offset_with_dst	object	Timezone offset from UTC including daylight saving time.
date	string	Current date in `YYYY-MM-DD` format.
date_time	string	Current date and time in `YYYY-MM-DD HH:mm:ss` format.
date_time_txt	string	Human-readable date and time string.
date_time_wti	string	Date and time with timezone information.
date_time_ymd	string	ISO-8601 formatted date and time with timezone offset.
current_time_unix	number	Unix timestamp representing the current date and time.
time_24	string	Current local time in 24-hour format.
time_12	string	Current local time in 12-hour format.
week	number	Week number of the current year.
month	number	Current month number.
year	number	Four-digit year.
year_abbr	string	Two-digit abbreviated year.
current_tz_abbreviation	string	Abbreviation of the timezone currently in effect.
current_tz_full_name	string	Full name of the timezone currently in effect.
standard_tz_abbreviation	string	Standard (non-DST) timezone abbreviation.
standard_tz_full_name	string	Full name of the standard timezone.
is_dst	boolean	Indicates whether daylight saving time is currently active.
dst_savings	number	Number of hours added during daylight saving time.
dst_exists	boolean	Indicates whether the region observes daylight saving time.
dst_tz_abbreviation	string	Abbreviation used during daylight saving time.
dst_tz_full_name	string	Full name used during daylight saving time.
dst_start	object	Represents a daylight saving time transition event including the moment when DST begins or ends.
dst_end	object	Represents a daylight saving time transition event including the moment when DST begins or ends.

View JSON Schema on GitHub

JSON Schema

{
  "$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."
        }
      }
    }
  }
}