TimeZone

Timezone information for the geographic location of the IP.

GeocodingIP GeolocationIP IntelligenceIP SecurityASN LookupAbuse ContactTimezoneAstronomyUser AgentThreat IntelligencePublic APIs

Properties

Name	Type	Description
name	string	IANA timezone identifier.
offset	number	UTC offset in hours (without DST).
offset_with_dst	number	Current UTC offset in hours, accounting for DST if active. Same as `offset` when DST is not in effect.
current_time	string	Current local time at the IP's location. Observed formats include `YYYY-MM-DDTHH:mm:ss±ZZZZ` and `YYYY-MM-DD HH:mm:ss.SSS±ZZZZ`.
current_time_unix	number	Current time as a Unix timestamp with millisecond precision.
current_tz_abbreviation	string	Abbreviation of the timezone currently in effect (may be standard or DST).
current_tz_full_name	string	Full name of the timezone currently in effect.
standard_tz_abbreviation	string	Abbreviation of the standard (non-DST) timezone.
standard_tz_full_name	string	Full name of the standard (non-DST) timezone.
is_dst	boolean	Whether Daylight Saving Time is currently active.
dst_savings	number	DST offset in hours applied on top of the standard offset when DST is active. `0` means no DST shift (either DST is not active or does not exist).
dst_exists	boolean	Whether this timezone observes Daylight Saving Time at all.
dst_tz_abbreviation	string	Abbreviation of the DST timezone. Empty string if DST is not observed.
dst_tz_full_name	string	Full name of the DST timezone. Empty string if DST is not observed.
dst_start	object	Start DST transition details. When `dst_exists` is `false`, this is returned as an empty object with no properties.
dst_end	object	End DST transition details. When `dst_exists` is `false`, this is returned as an empty object with no properties.

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/ip-location-time-zone-schema.json",
  "title": "TimeZone",
  "description": "Timezone information for the geographic location of the IP.",
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "description": "IANA timezone identifier.",
      "example": "Europe/Stockholm"
    },
    "offset": {
      "type": "number",
      "format": "float",
      "description": "UTC offset in hours (without DST).",
      "example": 1
    },
    "offset_with_dst": {
      "type": "number",
      "format": "float",
      "description": "Current UTC offset in hours, accounting for DST if active. Same as\n`offset` when DST is not in effect.\n",
      "example": 1
    },
    "current_time": {
      "type": "string",
      "description": "Current local time at the IP's location. Observed formats include\n`YYYY-MM-DDTHH:mm:ss\u00b1ZZZZ` and `YYYY-MM-DD HH:mm:ss.SSS\u00b1ZZZZ`.\n",
      "example": "2026-02-13 09:19:24.410+0100"
    },
    "current_time_unix": {
      "type": "number",
      "format": "float",
      "description": "Current time as a Unix timestamp with millisecond precision.",
      "example": 1770970764.41
    },
    "current_tz_abbreviation": {
      "type": "string",
      "description": "Abbreviation of the timezone currently in effect (may be standard or DST).\n",
      "example": "CET"
    },
    "current_tz_full_name": {
      "type": "string",
      "description": "Full name of the timezone currently in effect.",
      "example": "Central European Standard Time"
    },
    "standard_tz_abbreviation": {
      "type": "string",
      "description": "Abbreviation of the standard (non-DST) timezone.",
      "example": "CET"
    },
    "standard_tz_full_name": {
      "type": "string",
      "description": "Full name of the standard (non-DST) timezone.",
      "example": "Central European Standard Time"
    },
    "is_dst": {
      "type": "boolean",
      "description": "Whether Daylight Saving Time is currently active.",
      "example": false
    },
    "dst_savings": {
      "type": "number",
      "format": "float",
      "description": "DST offset in hours applied on top of the standard offset when DST is\nactive. `0` means no DST shift (either DST is not active or does not exist).\n",
      "example": 0
    },
    "dst_exists": {
      "type": "boolean",
      "description": "Whether this timezone observes Daylight Saving Time at all.",
      "example": true
    },
    "dst_tz_abbreviation": {
      "type": "string",
      "description": "Abbreviation of the DST timezone. Empty string if DST is not observed.\n",
      "example": "CEST"
    },
    "dst_tz_full_name": {
      "type": "string",
      "description": "Full name of the DST timezone. Empty string if DST is not observed.\n",
      "example": "Central European Summer Time"
    },
    "dst_start": {
      "description": "Start DST transition details. When `dst_exists` is `false`, this is\nreturned as an empty object with no properties.\n",
      "oneOf": [
        {
          "type": "object",
          "description": "Details about a DST transition (start or end). Only present when `dst_exists`\nis `true`. When `dst_exists` is `false`, `dst_start` and `dst_end` are\nreturned as empty objects with no properties.\n",
          "properties": {
            "utc_time": {
              "type": "string",
              "description": "UTC time of the transition, formatted as `YYYY-MM-DD TIME HH:mm`.",
              "example": "2026-03-29 TIME 01:00"
            },
            "duration": {
              "type": "string",
              "description": "Clock shift direction and amount (e.g. `+1.00H` for spring forward,\n`-1.00H` for fall back).\n",
              "example": "+1.00H"
            },
            "gap": {
              "type": "boolean",
              "description": "Whether this transition creates a gap in local time (clocks jump forward).\n`true` for DST start, `false` for DST end.\n",
              "example": true
            },
            "date_time_after": {
              "type": "string",
              "description": "Local time immediately after the transition.",
              "example": "2026-03-29 TIME 03:00"
            },
            "date_time_before": {
              "type": "string",
              "description": "Local time immediately before the transition.",
              "example": "2026-03-29 TIME 02:00"
            },
            "overlap": {
              "type": "boolean",
              "description": "Whether this transition creates an overlap in local time (clocks fall back,\nso the same local time occurs twice). `true` for DST end, `false` for DST\nstart.\n",
              "example": false
            }
          }
        },
        {
          "type": "object",
          "maxProperties": 0
        }
      ]
    },
    "dst_end": {
      "description": "End DST transition details. When `dst_exists` is `false`, this is\nreturned as an empty object with no properties.\n",
      "oneOf": [
        {
          "type": "object",
          "description": "Details about a DST transition (start or end). Only present when `dst_exists`\nis `true`. When `dst_exists` is `false`, `dst_start` and `dst_end` are\nreturned as empty objects with no properties.\n",
          "properties": {
            "utc_time": {
              "type": "string",
              "description": "UTC time of the transition, formatted as `YYYY-MM-DD TIME HH:mm`.",
              "example": "2026-03-29 TIME 01:00"
            },
            "duration": {
              "type": "string",
              "description": "Clock shift direction and amount (e.g. `+1.00H` for spring forward,\n`-1.00H` for fall back).\n",
              "example": "+1.00H"
            },
            "gap": {
              "type": "boolean",
              "description": "Whether this transition creates a gap in local time (clocks jump forward).\n`true` for DST start, `false` for DST end.\n",
              "example": true
            },
            "date_time_after": {
              "type": "string",
              "description": "Local time immediately after the transition.",
              "example": "2026-03-29 TIME 03:00"
            },
            "date_time_before": {
              "type": "string",
              "description": "Local time immediately before the transition.",
              "example": "2026-03-29 TIME 02:00"
            },
            "overlap": {
              "type": "boolean",
              "description": "Whether this transition creates an overlap in local time (clocks fall back,\nso the same local time occurs twice). `true` for DST end, `false` for DST\nstart.\n",
              "example": false
            }
          }
        },
        {
          "type": "object",
          "maxProperties": 0
        }
      ]
    }
  }
}