डेवलपर्स के लिए

एक मुफ़्त टाइम ज़ोन API

वही इंजन जो Hourora चलाता है, सीधे JSON में: कहीं का भी समय, डेलाइट सेविंग को समझने वाले रूपांतरण, हर IANA ज़ोन और उसकी घड़ी के बदलाव। बिना API key, बिना साइन-अप।

एक नज़र में

बेस URL: https://hourora.app/api/v1
फ़ॉर्मैट: JSON (UTF-8), केवल GET अनुरोध
ऑथेंटिकेशन: कोई नहीं: न API key, न साइन-अप, न कुकीज़
CORS: हर ऑरिजिन के लिए खुला, ताकि आप इसे ब्राउज़र से कॉल कर सकें
रेट लिमिट: प्रति क्लाइंट प्रति मिनट 120 अनुरोध
समय का डेटा: IANA tzdata 2026e, Hourora द्वारा कंपाइल किया गया
मशीन-पठनीय विवरण: OpenAPI 3.1 दस्तावेज़

लाइव आज़माएँ

कोई उदाहरण चुनें या पाथ बदलें, फिर उसे भेजें। अनुरोध आपके ब्राउज़र से सीधे API तक जाता है।

रिस्पॉन्स

रिस्पॉन्स यहाँ दिखेगा।

एंडपॉइंट

हर एंडपॉइंट GET का जवाब JSON में देता है। समय ISO 8601 में होते हैं; ऑफ़सेट UTC से पूर्व की ओर मिनटों में होते हैं (सर्दियों में न्यूयॉर्क −300 है) और टेक्स्ट के रूप में भी लिखे जाते हैं (−05:00)।

मौजूदा समय

GET/api/v1/time

किसी टाइम ज़ोन या शहर का मौजूदा समय: स्थानीय समय, UTC ऑफ़सेट, संक्षिप्त नाम, डेलाइट सेविंग और घड़ी का अगला बदलाव। बिना पैरामीटर के: UTC।

पैरामीटर

नाम	अर्थ
`tz`वैकल्पिक	IANA टाइम ज़ोन का नाम, जैसे Europe/London। Asia/Calcutta जैसे उपनाम स्वीकार किए जाते हैं और जवाब मौजूदा नाम के साथ दिया जाता है।
`city`वैकल्पिक	tz की जगह शहर का slug, जैसे london (slug /cities से खोजें)।

उदाहरण अनुरोध

curl "https://hourora.app/api/v1/time?tz=Europe/London"

उदाहरण रिस्पॉन्स

{
  "zone": "Europe/London",
  "local": "2026-10-16T04:11:37",
  "iso": "2026-10-16T04:11:37+01:00",
  "offsetMinutes": 60,
  "offset": "+01:00",
  "utcOffset": "UTC+1",
  "abbreviation": "BST",
  "dst": true,
  "city": null,
  "utc": "2026-10-16T03:11:37.874Z",
  "unixMs": 1792120297874,
  "date": "2026-10-16",
  "time": "04:11:37",
  "weekday": "Friday",
  "dayOfYear": 289,
  "isoWeek": 42,
  "dstObserved": true,
  "nextTransition": {
    "at": "2026-10-25T01:00:00.000Z",
    "unixMs": 1792890000000,
    "type": "dst-end",
    "fromOffsetMinutes": 60,
    "toOffsetMinutes": 0,
    "shiftMinutes": -60,
    "fromAbbreviation": "BST",
    "toAbbreviation": "GMT",
    "localBefore": "2026-10-25T02:00:00",
    "localAfter": "2026-10-25T01:00:00"
  },
  "tzdata": "2026e"
}

इस सर्वर का असली रिस्पॉन्स।

समय बदलें

GET/api/v1/convert

एक ज़ोन की घड़ी का समय दूसरे ज़ोन में दिखाया गया। बताता है जब समय डेलाइट सेविंग के गैप (वह मौजूद नहीं है) या ओवरलैप (वह दो बार आता है) में पड़ता है।

पैरामीटर

नाम	अर्थ
`from`आवश्यक	वह ज़ोन (या शहर का slug) जिसमें समय पढ़ा जाता है।
`to`आवश्यक	वह ज़ोन (या शहर का slug) जिसमें इसे दिखाना है।
`time`वैकल्पिक	from ज़ोन की घड़ी का समय, YYYY-MM-DDTHH:mm (सेकंड वैकल्पिक, बिना ऑफ़सेट), 1970–2060। डिफ़ॉल्ट: अभी।

उदाहरण अनुरोध

curl "https://hourora.app/api/v1/convert?from=America/New_York&to=Asia/Kolkata&time=2026-10-16T15:00"

उदाहरण रिस्पॉन्स

{
  "status": "ok",
  "requested": "2026-10-16T15:00:00",
  "utc": "2026-10-16T19:00:00.000Z",
  "unixMs": 1792177200000,
  "from": {
    "zone": "America/New_York",
    "local": "2026-10-16T15:00:00",
    "iso": "2026-10-16T15:00:00-04:00",
    "offsetMinutes": -240,
    "offset": "-04:00",
    "utcOffset": "UTC-4",
    "abbreviation": "EDT",
    "dst": true
  },
  "to": {
    "zone": "Asia/Kolkata",
    "local": "2026-10-17T00:30:00",
    "iso": "2026-10-17T00:30:00+05:30",
    "offsetMinutes": 330,
    "offset": "+05:30",
    "utcOffset": "UTC+5:30",
    "abbreviation": "IST",
    "dst": false,
    "dayOffset": 1
  },
  "differenceMinutes": 570,
  "tzdata": "2026e"
}

इस सर्वर का असली रिस्पॉन्स।

टाइम ज़ोन की सूची

GET/api/v1/zones

हर IANA टाइम ज़ोन, उसके मौजूदा UTC ऑफ़सेट, संक्षिप्त नाम, डेलाइट सेविंग की स्थिति, देशों और मुख्य शहर के साथ।

पैरामीटर

नाम	अर्थ
`country`वैकल्पिक	ISO 3166 देश कोड, जैसे GB, केवल उसी देश को रखने के लिए।

उदाहरण अनुरोध

curl "https://hourora.app/api/v1/zones?country=GB"

उदाहरण रिस्पॉन्स

{
  "asOf": "2026-10-16T03:11:37.874Z",
  "count": 1,
  "tzdata": "2026e",
  "zones": [
    {
      "id": "Europe/London",
      "offsetMinutes": 60,
      "offset": "+01:00",
      "utcOffset": "UTC+1",
      "abbreviation": "BST",
      "dst": true,
      "countries": [
        "GB",
        "GG",
        "IM"
      ],
      "mainCity": "London"
    }
  ]
}

इस सर्वर का असली रिस्पॉन्स; सूचियाँ छोटी करके पहले 3 आइटम तक रखी गई हैं।

एक टाइम ज़ोन

GET/api/v1/zones/{id}

एक IANA ज़ोन: उसके उपनाम (aliases), देश और शहर, उसका मौजूदा ऑफ़सेट, घड़ी का अगला बदलाव और किसी दिए गए साल के सभी बदलाव।

पैरामीटर

नाम	अर्थ
`id`पाथ में	IANA ज़ोन का नाम; स्लैश को रहने दें या उसे %2F के रूप में एन्कोड करें।
`year`वैकल्पिक	वह साल जिसके घड़ी के बदलाव सूचीबद्ध करने हैं, 1970–2060। डिफ़ॉल्ट: यह साल।

उदाहरण अनुरोध

curl "https://hourora.app/api/v1/zones/America%2FNew_York?year=2027"

उदाहरण रिस्पॉन्स

{
  "id": "America/New_York",
  "aliases": [
    "US/Eastern"
  ],
  "countries": [
    {
      "code": "US",
      "name": "United States"
    }
  ],
  "cities": [
    {
      "slug": "new-york",
      "name": "New York"
    },
    {
      "slug": "philadelphia",
      "name": "Philadelphia"
    },
    {
      "slug": "miami",
      "name": "Miami"
    }
  ],
  "now": {
    "zone": "America/New_York",
    "local": "2026-10-15T23:11:37",
    "iso": "2026-10-15T23:11:37-04:00",
    "offsetMinutes": -240,
    "offset": "-04:00",
    "utcOffset": "UTC-4",
    "abbreviation": "EDT",
    "dst": true,
    "utc": "2026-10-16T03:11:37.874Z",
    "standardOffsetMinutes": -300,
    "dstObserved": true
  },
  "nextTransition": {
    "at": "2026-11-01T06:00:00.000Z",
    "unixMs": 1793512800000,
    "type": "dst-end",
    "fromOffsetMinutes": -240,
    "toOffsetMinutes": -300,
    "shiftMinutes": -60,
    "fromAbbreviation": "EDT",
    "toAbbreviation": "EST",
    "localBefore": "2026-11-01T02:00:00",
    "localAfter": "2026-11-01T01:00:00"
  },
  "year": 2027,
  "dstObservedInYear": true,
  "transitions": [
    {
      "at": "2027-03-14T07:00:00.000Z",
      "unixMs": 1805007600000,
      "type": "dst-start",
      "fromOffsetMinutes": -300,
      "toOffsetMinutes": -240,
      "shiftMinutes": 60,
      "fromAbbreviation": "EST",
      "toAbbreviation": "EDT",
      "localBefore": "2027-03-14T02:00:00",
      "localAfter": "2027-03-14T03:00:00"
    },
    {
      "at": "2027-11-07T06:00:00.000Z",
      "unixMs": 1825567200000,
      "type": "dst-end",
      "fromOffsetMinutes": -240,
      "toOffsetMinutes": -300,
      "shiftMinutes": -60,
      "fromAbbreviation": "EDT",
      "toAbbreviation": "EST",
      "localBefore": "2027-11-07T02:00:00",
      "localAfter": "2027-11-07T01:00:00"
    }
  ],
  "tzdata": "2026e"
}

इस सर्वर का असली रिस्पॉन्स; सूचियाँ छोटी करके पहले 3 आइटम तक रखी गई हैं।

शहर खोजें

GET/api/v1/cities

वे शहर जिनका नाम मेल खाता है, सबसे अच्छे मेल और सबसे बड़े शहर पहले, हर एक अपने देश, निर्देशांक और टाइम ज़ोन के साथ।

पैरामीटर

नाम	अर्थ
`q`आवश्यक	शहर के नाम का हिस्सा, एक्सेंट वैकल्पिक (अधिकतम 80 अक्षर)।
`limit`वैकल्पिक	कितने नतीजे, 1–50। डिफ़ॉल्ट 10।
`country`वैकल्पिक	ISO 3166 देश कोड, जैसे GB, केवल उसी देश को रखने के लिए।

उदाहरण अनुरोध

curl "https://hourora.app/api/v1/cities?q=lond&limit=3"

उदाहरण रिस्पॉन्स

{
  "query": "lond",
  "count": 3,
  "total": 7,
  "cities": [
    {
      "slug": "london",
      "name": "London",
      "asciiName": "London",
      "country": {
        "code": "GB",
        "name": "United Kingdom"
      },
      "region": "Westminster",
      "zone": "Europe/London",
      "lat": 51.5,
      "lng": -0.1167,
      "population": 7994105,
      "capital": true,
      "url": "https://hourora.app/en/london"
    },
    {
      "slug": "londrina",
      "name": "Londrina",
      "asciiName": "Londrina",
      "country": {
        "code": "BR",
        "name": "Brazil"
      },
      "region": "Paraná",
      "zone": "America/Sao_Paulo",
      "lat": -23.3,
      "lng": -51.18,
      "population": 496035,
      "capital": false,
      "url": "https://hourora.app/en/londrina"
    },
    {
      "slug": "london-ontario",
      "name": "London",
      "asciiName": "London",
      "country": {
        "code": "CA",
        "name": "Canada"
      },
      "region": "Ontario",
      "zone": "America/Toronto",
      "lat": 42.97,
      "lng": -81.25,
      "population": 340900,
      "capital": false,
      "url": "https://hourora.app/en/london-ontario"
    }
  ]
}

इस सर्वर का असली रिस्पॉन्स।

एक शहर

GET/api/v1/cities/{slug}

उसके slug से एक शहर, उसके टाइम ज़ोन के मौजूदा ऑफ़सेट और घड़ी के अगले बदलाव के साथ।

पैरामीटर

नाम	अर्थ
`slug`पाथ में	शहर का slug, जैसे tokyo।

उदाहरण अनुरोध

curl "https://hourora.app/api/v1/cities/tokyo"

उदाहरण रिस्पॉन्स

{
  "slug": "tokyo",
  "name": "Tokyo",
  "asciiName": "Tokyo",
  "country": {
    "code": "JP",
    "name": "Japan"
  },
  "region": "Tokyo",
  "zone": "Asia/Tokyo",
  "lat": 35.685,
  "lng": 139.7514,
  "population": 22006300,
  "capital": true,
  "url": "https://hourora.app/en/tokyo",
  "now": {
    "zone": "Asia/Tokyo",
    "local": "2026-10-16T12:11:37",
    "iso": "2026-10-16T12:11:37+09:00",
    "offsetMinutes": 540,
    "offset": "+09:00",
    "utcOffset": "UTC+9",
    "abbreviation": "JST",
    "dst": false,
    "utc": "2026-10-16T03:11:37.874Z"
  },
  "nextTransition": null,
  "tzdata": "2026e"
}

इस सर्वर का असली रिस्पॉन्स।

निर्देशांक से टाइम ज़ोन

GET/api/v1/lookup

किसी अक्षांश और देशांतर के सबसे पास का सूचीबद्ध शहर, और उसका टाइम ज़ोन। यह एक अनुमान है: ज़ोन की सीमाएँ मॉडल नहीं की गई हैं।

पैरामीटर

नाम	अर्थ
`lat`आवश्यक	दशमलव डिग्री में अक्षांश, −90 से 90।
`lng`आवश्यक	दशमलव डिग्री में देशांतर, −180 से 180।

उदाहरण अनुरोध

curl "https://hourora.app/api/v1/lookup?lat=48.85&lng=2.35"

उदाहरण रिस्पॉन्स

{
  "query": {
    "lat": 48.85,
    "lng": 2.35
  },
  "approximate": true,
  "method": "nearest listed city (great-circle distance); time-zone borders are not modelled",
  "distanceKm": 2.2,
  "city": {
    "slug": "paris",
    "name": "Paris",
    "asciiName": "Paris",
    "country": {
      "code": "FR",
      "name": "France"
    },
    "region": "Île-de-France",
    "zone": "Europe/Paris",
    "lat": 48.8667,
    "lng": 2.3333,
    "population": 4957589,
    "capital": true,
    "url": "https://hourora.app/en/paris"
  },
  "zone": "Europe/Paris",
  "now": {
    "zone": "Europe/Paris",
    "local": "2026-10-16T05:11:37",
    "iso": "2026-10-16T05:11:37+02:00",
    "offsetMinutes": 120,
    "offset": "+02:00",
    "utcOffset": "UTC+2",
    "abbreviation": "CEST",
    "dst": true,
    "utc": "2026-10-16T03:11:37.874Z"
  },
  "tzdata": "2026e"
}

इस सर्वर का असली रिस्पॉन्स।

डेटा वर्ज़न

GET/api/v1/tzdata

जवाब IANA टाइम ज़ोन डेटाबेस की किस रिलीज़ से आते हैं, और Hourora ने अपना डेटा आख़िरी बार कब अपडेट किया।

पैरामीटर

कोई पैरामीटर नहीं।

उदाहरण अनुरोध

curl "https://hourora.app/api/v1/tzdata"

उदाहरण रिस्पॉन्स

{
  "version": "2026e",
  "source": "IANA Time Zone Database",
  "sourceUrl": "https://www.iana.org/time-zones",
  "dataDate": "2026-10-13",
  "range": {
    "from": "1970-01-01",
    "to": "2060-12-31"
  },
  "zones": 344,
  "links": 253,
  "cities": 7269,
  "note": "Outside the compiled range, offsets fall back to the server runtime's own tzdata."
}

इस सर्वर का असली रिस्पॉन्स।

त्रुटियाँ

त्रुटि भी JSON में होती है: HTTP स्टेटस, आपके प्रोग्राम के लिए एक स्थिर कोड और लोगों के लिए एक संदेश।

{
  "error": {
    "code": "unknown_zone",
    "message": "\"Mars/Base\" is not an IANA time zone name. List them with /api/v1/zones."
  }
}

स्टेटस	कोड	कब
400	`missing_parameter, invalid_parameter`	कोई पैरामीटर मौजूद नहीं है या अपेक्षित रूप में नहीं है।
404	`unknown_zone, unknown_city, unknown_country, not_found`	ऐसा कोई टाइम ज़ोन, शहर, देश या एंडपॉइंट नहीं है।
429	`rate_limited`	आपके क्लाइंट से बहुत ज़्यादा अनुरोध; Retry-After में दिए गए सेकंड तक इंतज़ार करें।
500	`internal_error`	हमारी तरफ़ कुछ गड़बड़ हुई। कृपया बाद में फिर से कोशिश करें।

यह कैसे काम करता है

सीमाएँ और कैशिंग

हर क्लाइंट प्रति मिनट 120 अनुरोध तक भेज सकता है, थोड़ी देर के बर्स्ट की अनुमति के साथ। उससे ज़्यादा होने पर API Retry-After हेडर के साथ 429 लौटाता है। यह सीमा एक मुफ़्त सेवा की रक्षा करती है; अगर आपको ज़्यादा चाहिए, तो कैश करें।

हर रिस्पॉन्स बताता है कि उसे कितनी देर कैश किया जा सकता है (Cache-Control)। मौजूदा समय कभी कैश नहीं होता; ज़ोन की सूचियाँ, शहर का विवरण और लुकअप पाँच मिनट के लिए; शहर की खोज और किसी दिए गए समय के रूपांतरण एक दिन के लिए।

घड़ी बना रहे हैं? ऑफ़सेट एक बार लें, स्थानीय रूप से टिक करें, और रिस्पॉन्स में बताए गए घड़ी के अगले बदलाव के बाद फिर से लें। हर सेकंड पोल करने की ज़रूरत नहीं है।

जवाब कहाँ से आते हैं

ऑफ़सेट, संक्षिप्त नाम और घड़ी के बदलाव IANA टाइम ज़ोन डेटाबेस की Hourora की अपनी कंपाइल की गई कॉपी, रिलीज़ 2026e, से 1970–2060 के लिए आते हैं। इस सीमा के बाहर सर्वर का बिल्ट-इन डेटा इस्तेमाल होता है, जो पुराना हो सकता है।

रूपांतरण डेलाइट सेविंग की सीमाओं को स्पष्ट रूप से हल करते हैं: जो समय घड़ियाँ आगे होने पर छूट जाता है उसे गैप के रूप में बताया जाता है, और जो समय घड़ियाँ पीछे होने पर दो बार आता है उसे ओवरलैप के रूप में, दोनों क्षणों के साथ।

निर्देशांक लुकअप लगभग 7,200 सूचीबद्ध शहरों में से सबसे पास वाला शहर और उस शहर का ज़ोन लौटाता है। किसी सीमा के पास, समुद्र में या कम आबादी वाले इलाक़े में यह उस ज़ोन से अलग हो सकता है जो उस बिंदु पर वास्तव में लागू होता है।

उपयोग की शर्तें

निजी और व्यावसायिक उपयोग के लिए मुफ़्त। न API key, न अकाउंट।
श्रेय देना सराहनीय है, ज़रूरी नहीं: जहाँ डेटा दिखता है उसके पास hourora.app का एक लिंक।
जैसा है वैसा उपलब्ध, बिना सर्विस-लेवल एग्रीमेंट या उपलब्धता की गारंटी के। इसे वहाँ इस्तेमाल न करें जहाँ ग़लत या ग़ायब समय से नुक़सान हो सकता है।
जवाब IANA tzdata 2026e के अनुसार हैं। जब सरकारें अपनी घड़ियाँ बदलती हैं, तो डेटा अगली IANA रिलीज़ के साथ अपडेट होता है।
वर्ज़न 1 संगत बना रहता है: नए फ़ील्ड जोड़े जा सकते हैं, कुछ भी हटाया या नाम बदला नहीं जाता। असंगत बदलाव /api/v2 के रूप में आएँगे।
कृपया रेट लिमिट के भीतर रहें और रिस्पॉन्स कैश करें। दुरुपयोग वाला ट्रैफ़िक ब्लॉक किया जा सकता है।

सवाल

जानने योग्य बातें

क्या Hourora API वाकई मुफ़्त है?

हाँ। न API key, न अकाउंट और न कोई पेड टियर। प्रति क्लाइंट रेट लिमिट सेवा को सबके लिए निष्पक्ष रखती है।

क्या इसे ब्राउज़र में JavaScript से कॉल किया जा सकता है?

हाँ। हर एंडपॉइंट किसी भी वेबसाइट से cross-origin अनुरोधों (CORS) की अनुमति देता है, और किसी क्रेडेंशियल की ज़रूरत नहीं है।

यह डेलाइट सेविंग टाइम को कैसे संभालता है?

हर जवाब IANA नियमों से ठीक उस क्षण के लिए गणना किया जाता है। convert एंडपॉइंट यह भी बताता है कि जब माँगा गया घड़ी का समय मौजूद नहीं है (घड़ियाँ आगे होने पर) या दो बार आता है (घड़ियाँ पीछे होने पर)।

निर्देशांक लुकअप कितना सटीक है?

यह सबसे पास के सूचीबद्ध शहर का टाइम ज़ोन लौटाता है, जो लगभग हर उस जगह सही है जहाँ लोग रहते हैं। यह ज़ोन की सीमाएँ मॉडल नहीं करता, इसलिए सीमा के पास या समुद्र में ग़लत हो सकता है।