IPGeolocation.io · Schema

TimeConversionResponse

Response returned by the Timezone Conversion API. Contains the original timestamp, the converted timestamp in the destination timezone, and the time difference between the two locations or timezones. The conversion can be performed using timezone names, geographic coordinates, location addresses, airport codes (IATA/ICAO), or UN/LOCODE identifiers.

GeocodingIP GeolocationIP IntelligenceIP SecurityASN LookupAbuse ContactTimezoneAstronomyUser AgentThreat IntelligencePublic APIs

Properties

Name Type Description
original_time string The original timestamp before conversion. If the `time` parameter is omitted, this value represents the current time at the source location.
converted_time string The converted timestamp in the destination timezone.
diff_hour number Time difference between the source and destination timezones expressed in hours.
diff_min number Time difference between the source and destination timezones expressed in minutes.
View JSON Schema on GitHub

JSON Schema

timezone-time-conversion-response-schema.json Raw ↑
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://raw.githubusercontent.com/api-evangelist/ipgeolocation/refs/heads/main/json-schema/timezone-time-conversion-response-schema.json",
  "title": "TimeConversionResponse",
  "description": "Response returned by the Timezone Conversion API.\n\nContains the original timestamp, the converted timestamp in the\ndestination timezone, and the time difference between the two\nlocations or timezones.\n\nThe conversion can be performed using timezone names, geographic\ncoordinates, location addresses, airport codes (IATA/ICAO),\nor UN/LOCODE identifiers.\n",
  "type": "object",
  "properties": {
    "original_time": {
      "type": "string",
      "description": "The original timestamp before conversion. If the `time`\nparameter is omitted, this value represents the current\ntime at the source location.\n",
      "example": "2024-12-08 11:00"
    },
    "converted_time": {
      "type": "string",
      "description": "The converted timestamp in the destination timezone.\n",
      "example": "2024-12-08 18:30:00"
    },
    "diff_hour": {
      "type": "number",
      "format": "float",
      "description": "Time difference between the source and destination\ntimezones expressed in hours.\n",
      "example": 7.5
    },
    "diff_min": {
      "type": "number",
      "description": "Time difference between the source and destination\ntimezones expressed in minutes.\n",
      "example": 450
    }
  }
}