{
"ok": true,
"data": {
"start": "2026-11-02T00:00:00Z",
"end": "2026-12-01T17:30:00Z",
"timeZone": null,
"direction": "forward",
"totals": {
"seconds": 2568600,
"minutes": 42810,
"hours": 713.5,
"days": 29.729167,
"weeks": 4.247024,
"months": 0,
"years": 0
},
"calendarDays": 29,
"calendar": {
"years": 0,
"months": 0,
"days": 29,
"hours": 17,
"minutes": 30,
"seconds": 0,
"iso": "P29DT17H30M"
},
"businessDays": 20,
"businessDayDetails": {
"convention": "Counts business days after the start date up to and including the end date.",
"weekendDays": [
"Sunday",
"Saturday"
],
"weekendDaysSkipped": 8,
"holidaysSkipped": 1
},
"note": "Inputs without a UTC offset are read in timeZone when given, otherwise as UTC. Calendar math (months, days) runs on wall-clock time; hours, minutes, and seconds are exact elapsed time. totals.months and totals.years are whole calendar units; the other totals are exact elapsed time."
}
}
curl --location --request POST 'https://zylalabs.com/api/15186/date+difference+and+business+days+api/40604/difference+between+two+dates' --header 'Authorization: Bearer YOUR_API_KEY'
--data-raw '{"start":"2026-11-02","end":"2026-12-01T17:30:00Z","holidays":["2026-11-26"]}'
{
"ok": true,
"data": {
"input": "2024-01-31T00:00:00Z",
"timeZone": null,
"duration": "P1M2DT3H",
"applied": {
"years": 0,
"months": 1,
"weeks": 0,
"days": 2,
"hours": 3,
"minutes": 0,
"seconds": 0
},
"result": "2024-03-02T03:00:00Z",
"resultIso": "2024-03-02T03:00:00Z",
"resultUtc": "2024-03-02T03:00:00.000Z",
"resultDate": "2024-03-02",
"weekday": "Saturday",
"unixTimestamp": 1709348400,
"clamped": true,
"adjustedForDstGap": false,
"note": "Adding months or years clamps to the last valid day of the target month (for example, Jan 31 + 1 month = Feb 28, or Feb 29 in a leap year). Order: years and months, then weeks and days on the wall clock, then hours, minutes, and seconds as exact elapsed time."
}
}
curl --location --request POST 'https://zylalabs.com/api/15186/date+difference+and+business+days+api/40605/add+or+subtract+a+duration' --header 'Authorization: Bearer YOUR_API_KEY'
--data-raw '{"date":"2024-01-31","duration":"P1M2DT3H"}'
{
"ok": true,
"data": {
"start": "2026-11-25",
"startIsBusinessDay": true,
"days": 3,
"result": "2026-12-01",
"weekday": "Tuesday",
"calendarDaysSpanned": 6,
"weekendDays": [
"Sunday",
"Saturday"
],
"weekendDaysSkipped": 2,
"holidaysSkipped": 1,
"note": "The start date is not counted. Each step moves to the next (or previous, for negative days) date that is not a weekend day or holiday. With days = 0 the start date is returned unchanged. Uses the calendar date of the input; any time or offset is ignored."
}
}
curl --location --request POST 'https://zylalabs.com/api/15186/date+difference+and+business+days+api/40606/add+business+days+to+a+date' --header 'Authorization: Bearer YOUR_API_KEY'
--data-raw '{"date":"2026-11-25","days":3,"holidays":["2026-11-26"]}'
{
"ok": true,
"data": {
"input": "2026-07-01T12:00:00",
"utc": "2026-07-01T16:00:00.000Z",
"unixTimestamp": 1782921600,
"from": {
"timeZone": "America/New_York",
"localDateTime": "2026-07-01T12:00:00",
"iso": "2026-07-01T12:00:00-04:00",
"offset": "-04:00",
"offsetMinutes": -240,
"isDST": true,
"abbreviation": "EDT",
"formatted": "Wednesday, July 1, 2026 at 12:00:00 PM EDT"
},
"to": {
"timeZone": "Europe/London",
"localDateTime": "2026-07-01T17:00:00",
"iso": "2026-07-01T17:00:00+01:00",
"offset": "+01:00",
"offsetMinutes": 60,
"isDST": true,
"abbreviation": "GMT+1",
"formatted": "Wednesday, July 1, 2026 at 5:00:00 PM GMT+1"
},
"offsetDifferenceMinutes": 300,
"ambiguousLocalTime": false,
"nonexistentLocalTime": false,
"note": "Uses the Intl time zone database of the runtime. A local time repeated by a DST fall-back resolves to the earlier instant; a local time skipped by a spring-forward gap moves forward by the gap."
}
}
curl --location --request POST 'https://zylalabs.com/api/15186/date+difference+and+business+days+api/40607/convert+a+date-time+between+time+zones' --header 'Authorization: Bearer YOUR_API_KEY'
--data-raw '{"datetime":"2026-07-01T12:00:00","from":"America/New_York","to":"Europe/London"}'
{
"ok": true,
"data": {
"date": "2024-02-29",
"year": 2024,
"month": 2,
"monthName": "February",
"day": 29,
"weekday": "Thursday",
"weekdayNumber": 4,
"isoWeekday": 4,
"isoWeek": 9,
"isoWeekYear": 2024,
"isoWeekDate": "2024-W09-4",
"dayOfYear": 60,
"daysRemainingInYear": 306,
"quarter": 1,
"isLeapYear": true,
"daysInMonth": 29,
"daysInYear": 366,
"isWeekend": false,
"unixTimestamp": 1709164800,
"note": "unixTimestamp is midnight UTC at the start of this date, in seconds."
}
}
curl --location --request GET 'https://zylalabs.com/api/15186/date+difference+and+business+days+api/40608/calendar+facts+for+a+date?date=2024-02-29' --header 'Authorization: Bearer YOUR_API_KEY'
{
"ok": true,
"data": {
"input": "P1DT2H3M4.5S",
"normalized": "P1DT2H3M4.5S",
"negative": false,
"components": {
"years": 0,
"months": 0,
"weeks": 0,
"days": 1,
"hours": 2,
"minutes": 3,
"seconds": 4.5
},
"totalSeconds": 93784.5,
"totalSecondsApproximate": false,
"note": "Exact: weeks are 7 days, days are 24 hours (DST shifts are not applied without a start date)."
}
}
curl --location --request POST 'https://zylalabs.com/api/15186/date+difference+and+business+days+api/40609/parse+an+iso+8601+duration' --header 'Authorization: Bearer YOUR_API_KEY'
--data-raw '{"duration":"P1DT2H3M4.5S"}'
{
"ok": true,
"data": {
"seconds": 5400,
"largestUnit": "hours",
"iso": "PT1H30M",
"components": {
"years": 0,
"months": 0,
"weeks": 0,
"days": 0,
"hours": 1,
"minutes": 30,
"seconds": 0
},
"note": "Months and years are never emitted because their length varies. Seconds are rounded to milliseconds."
}
}
curl --location --request GET 'https://zylalabs.com/api/15186/date+difference+and+business+days+api/40610/format+duration+from+query+seconds' --header 'Authorization: Bearer YOUR_API_KEY'
{
"ok": true,
"data": {
"seconds": 93784.25,
"largestUnit": "days",
"iso": "P1DT2H3M4.25S",
"components": {
"years": 0,
"months": 0,
"weeks": 0,
"days": 1,
"hours": 2,
"minutes": 3,
"seconds": 4.25
},
"note": "Months and years are never emitted because their length varies. Seconds are rounded to milliseconds."
}
}
curl --location --request POST 'https://zylalabs.com/api/15186/date+difference+and+business+days+api/40611/format+seconds+as+an+iso+8601+duration' --header 'Authorization: Bearer YOUR_API_KEY'
--data-raw '{"seconds":93784.25}'
साइन अप करने के बाद, प्रत्येक डेवलपर को एक पर्सनल API एक्सेस की असाइन की जाती है, जो अक्षरों और अंकों का एक यूनिक संयोजन होता है, जिसका उपयोग हमारे API एंडपॉइंट तक पहुंचने के लिए किया जाता है। प्रमाणीकरण के लिए तारीखों का अंतर और कार्यदिवस API के साथ बस अपने बेयरर टोकन को Authorization हेडर में शामिल करें।
| हेडर | विवरण |
|---|---|
Authorization
|
आवश्यक
होना चाहिए Bearer access_key. जब आप सब्सक्राइब हों तो ऊपर "Your API Access Key" देखें।
|
कोई लंबी अवधि की प्रतिबद्धता नहीं। कभी भी अपग्रेड, डाउनग्रेड या कैंसल करें। फ्री ट्रायल में 50 रिक्वेस्ट तक शामिल हैं।
तारीखों के बीच अंतर, कस्टम सप्ताहांत और छुट्टियों सहित कार्यदिवस, महीने के अंत तक सीमित अवधि की गणना, समय क्षेत्र रूपांतरण, ISO सप्ताह की जानकारी और ISO 8601 अवधियाँ
डिफ़ॉल्ट रूप से गणना में प्रारंभ तिथि के बाद के कार्यदिवस शामिल होते हैं और समाप्ति तिथि भी शामिल होती है इसलिए सोमवार से शुक्रवार तक का अंतर 4 होता है और सोमवार में 4 कार्यदिवस जोड़ने पर शुक्रवार आता है इसलिए diff और add सहमत होते हैं स्प्रेडशीट NETWORKDAYS की तरह प्रारंभ तिथि को भी गिनने के लिए includeStart को true पर सेट करें
हाँ weekendDays को 0–6 संख्याओं के रूप में पास करें (0 = रविवार) या "Fri" और "Sat" जैसे नामों के रूप में पास करें holidays को YYYY-MM-DD फ़ॉर्मैट में अधिकतम 366 तारीखों के रूप में पास करें API में अंतर्निहित छुट्टी कैलेंडर शामिल नहीं है इसलिए आप पर लागू होने वाली तारीखें भेजें .
परिणाम को लक्षित महीने के अंतिम मान्य दिन तक सीमित किया जाता है: 2025-02-28 या लीप वर्ष में 2024-02-29। ऐसा होने पर प्रतिक्रिया clamped को true पर सेट करती है। 29 फ़रवरी में एक वर्ष जोड़ने पर 28 फ़रवरी मिलता है
Diff या add को IANA timeZone दें। दिन और महीने दीवार घड़ी का समय बनाए रखते हैं, जबकि घंटे, मिनट और सेकंड बीता हुआ सटीक समय दर्शाते हैं। न्यूयॉर्क में घड़ी आगे बढ़ने वाला दिन 1 कैलेंडर दिन का होता है, लेकिन 23 घंटे का। अस्तित्वहीन स्थानीय समय अंतराल जितना आगे बढ़ जाता है, और दोहराए गए स्थानीय समय पहले वाले क्षण पर निर्धारित होते हैं। दोनों मामलों को चिह्नित किया जाता है
वर्ष 0001-9999 के लिए ISO 8601 तिथियाँ (YYYY-MM-DD) और दिनांक-समय (YYYY-MM-DDTHH:MM[:SS[.fff]]) वैकल्पिक Z या धन/ऋण HH:MM ऑफ़सेट के साथ। ऑफ़सेट के बिना मान, यदि आप कोई timeZone देते हैं तो उसमें पढ़े जाते हैं, अन्यथा UTC के रूप में। 2026-02-29 जैसी अमान्य तिथियों पर स्पष्ट संदेश के साथ 400 मिलता है
वर्षों और महीनों की अवधि अलग-अलग होती है इसलिए parse-duration उनके लिए औसत मानों का उपयोग करता है (प्रति वर्ष 365.2425 दिन प्रति माह 30.436875 दिन) और totalSecondsApproximate को true पर सेट करता है। सटीक परिणाम के लिए add एंडपॉइंट का उपयोग करके अवधि को किसी वास्तविक प्रारंभ तिथि में जोड़ें .
ISO 8601 सप्ताह: सप्ताह सोमवार से शुरू होते हैं और सप्ताह 1 में वर्ष का पहला गुरुवार होता है उदाहरण के लिए 2021-01-03 सप्ताह-वर्ष 2020 के सप्ताह 53 में है प्रतिक्रिया में isoWeek और isoWeekYear दोनों शामिल हैं Only the translated text should be returned Do not add periods or commas If there was an error in the translation only "error" should be returned
सीमाएँ और स्थानांतरण अधिकतम 200 वर्ष तक हो सकते हैं, छुट्टियों की सूचियों में अधिकतम 366 तारीखें हो सकती हैं, कारोबारी दिनों के चरण प्लस या माइनस 50,000 तक हो सकते हैं, और अनुरोध के मुख्य भाग अधिकतम 32 KiB तक हो सकते हैं। इन सीमाओं से बाहर के अनुरोधों पर 400 लौटाया जाता है, जिसमें सीमा का नाम बताया जाता है। .
यह सामान्यीकृत प्रारंभ और अंत मान, दिशा, सेकंड से लेकर सप्ताह तक की सटीक कुल अवधियाँ, पूरे कैलेंडर महीने और वर्ष, कैलेंडर दिनों की संख्या, ISO अवधि के साथ कैलेंडर विवरण और कार्यदिवस के परिणाम लौटाता है कार्यदिवस के विवरण में सप्ताहांत की परंपरा और छोड़े गए सप्ताहांत तथा छुट्टियों की संख्या शामिल हैं
एंडपॉइंट पहले वर्षों और महीनों को लागू करता है, फिर स्थानीय घड़ी के समय के अनुसार सप्ताह और दिन, इसके बाद बीते हुए समय के रूप में घंटे, मिनट और सेकंड लागू करता है प्रतिक्रिया में लागू किए गए घटक, कई फ़ॉर्मैट में परिणाम, सप्ताह का दिन, यूनिक्स टाइमस्टैम्प, क्लैम्पिंग की स्थिति और DST गैप समायोजन की स्थिति शामिल होती है
यह मूल तारीख बताता है कि वह कार्यदिवस थी या नहीं अनुरोधित बदलाव परिणामी तारीख और सप्ताह का दिन शामिल कैलेंडर दिनों की संख्या सप्ताहांत का विन्यास और छोड़े गए सप्ताहांतों और छुट्टियों की संख्या शून्य-दिन का बदलाव आरंभिक तारीख को अपरिवर्तित लौटाता है आरंभिक तारीख की गिनती कभी नहीं होती
उत्तर में UTC क्षण और Unix टाइमस्टैम्प के साथ स्रोत और गंतव्य समय-क्षेत्र ऑब्जेक्ट भी शामिल हैं प्रत्येक ऑब्जेक्ट स्थानीय दिनांक-समय ऑफ़सेट सहित ISO मान मिनटों में ऑफ़सेट DST फ़्लैग संक्षिप्त नाम और फ़ॉर्मैट किया गया पाठ प्रदान करता है यह ऑफ़सेट का अंतर और अस्पष्ट या अस्तित्वहीन स्थानीय-समय फ़्लैग भी रिपोर्ट करता है
किसी तारीख के लिए, यह सप्ताह का दिन, ISO सप्ताह का दिन और सप्ताह की तारीख, ISO सप्ताह और सप्ताह-वर्ष, वर्ष का दिन, शेष दिन, तिमाही, लीप वर्ष की स्थिति, महीने और वर्ष में दिनों की संख्या, सप्ताहांत की स्थिति, और उस तारीख की शुरुआत में मध्यरात्रि UTC का Unix टाइमस्टैम्प लौटाता है
पार्सर मूल और सामान्यीकृत अवधि, उसका चिह्न, और वर्ष, महीने, सप्ताह, दिन, घंटे, मिनट तथा सेकंड के अलग-अलग घटक लौटाता है यह कुल सेकंड भी लौटाता है वर्षों या महीनों को शामिल करने वाले योग अनुमानित होते हैं सप्ताह, दिन और छोटी इकाइयाँ निश्चित-अवधि नियमों के तहत सटीक होती हैं
फ़ॉर्मेटिंग एंडपॉइंट इनपुट सेकंड, चुनी गई सबसे बड़ी इकाई, ISO अवधि स्ट्रिंग और घटकों का विवरण लौटाते हैं। वे सप्ताह, दिन, घंटे, मिनट और सेकंड का उपयोग करते हैं, कभी भी महीने या वर्ष का नहीं। उदाहरण के लिए, 5,400 सेकंड PT1H30M बन जाते हैं, और आंशिक सेकंड को निकटतम मिलीसेकंड तक पूर्णांकित किया जाता है
इंटरऑपरेबिलिटी के लिए ISO स्ट्रिंग्स, गणनाओं और प्रदर्शन के लिए संरचित घटकों, और उन सिस्टमों के लिए Unix टाइमस्टैम्प का उपयोग करें जिन्हें epoch सेकंड की आवश्यकता होती है। अवधि के लिए, भंडारण या हस्तांतरण हेतु ISO मान और उपयोगकर्ता को दिखाए जाने वाले लेबल के लिए घटकों का उपयोग करें। परिणामों को सार्वभौमिक रूप से सटीक मानने से पहले अनुमान, सीमा-निर्धारण और DST फ़्लैग की जाँच करें