{
"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}'
Después de registrarte, a cada desarrollador se le asigna una clave de acceso a la API personal, una combinación única de letras y dígitos proporcionada para acceder a nuestro endpoint de la API. Para autenticarte con el Diferencia entre fechas y días hábiles API simplemente incluye tu token de portador en el encabezado de Autorización.
| Encabezado | Descripción |
|---|---|
Autorización
|
Requerido
Debería ser Bearer access_key. Consulta "Tu Clave de Acceso a la API" arriba cuando estés suscrito.
|
Sin compromiso a largo plazo. Mejora, reduce o cancela en cualquier momento. La Prueba Gratuita incluye hasta 50 solicitudes.
Diferencias entre fechas, días hábiles con fines de semana y festivos personalizados, cálculos de duración con ajuste al final del mes, conversión de zonas horarias, información sobre semanas ISO y duraciones ISO 8601
Por defecto, el conteo incluye los días hábiles posteriores a la fecha de inicio, hasta la fecha de finalización inclusive. Por lo tanto, la diferencia de lunes a viernes es 4 y, al sumar 4 días hábiles a lunes, se obtiene viernes, así que la diferencia y la suma coinciden. Establece includeStart en true para contar también la fecha de inicio, como en la función NETWORKDAYS de las hojas de cálculo.
Sí. Envía weekendDays como números del 0 al 6 (0 = domingo) o nombres como "Fri" y "Sat". Envía holidays con hasta 366 fechas en formato YYYY-MM-DD. La API no incluye un calendario de festivos integrado, así que debes enviar las fechas que correspondan en tu caso. .
El resultado se ajusta al último día válido del mes de destino: 2025-02-28, o 2024-02-29 en un año bisiesto. La respuesta establece clamped en true cuando esto sucede. El 29 de febrero más un año da el 28 de febrero
Pasa una zona horaria de IANA a diff o add. Los días y los meses mantienen la hora del reloj, y las horas, los minutos y los segundos son tiempo transcurrido exacto. El día del adelanto de la hora en Nueva York es 1 día calendario, pero 23 horas. Las horas locales inexistentes avanzan según la duración del salto, y las horas locales repetidas se resuelven en el instante anterior. Ambos casos se señalan
Fechas ISO 8601 (AAAA-MM-DD) y fechas y horas (AAAA-MM-DDTHH:MM[:SS[.fff]]) con un desplazamiento opcional Z o de más o menos HH:MM, para años del 0001 al 9999. Los valores sin desplazamiento se interpretan en timeZone si se proporciona uno; de lo contrario, como UTC. Las fechas no válidas, como 2026-02-29, devuelven un error 400 con un mensaje claro.
Los años y los meses varían en duración, por lo que parse-duration utiliza promedios para ellos (365.2425 días por año, 30.436875 días por mes) y establece totalSecondsApproximate en true Para obtener un resultado exacto, suma la duración a una fecha de inicio real con el endpoint add
La semana ISO 8601: las semanas comienzan el lunes y la semana 1 contiene el primer jueves del año. Por ejemplo, 2021-01-03 pertenece a la semana 53 del año-semana 2020. La respuesta incluye tanto isoWeek como isoWeekYear. .
Los rangos y desplazamientos pueden ser de hasta 200 años, las listas de festivos de hasta 366 fechas, los pasos de días hábiles de hasta más o menos 50 000 y los cuerpos de las solicitudes de hasta 32 KiB Las solicitudes que excedan estos límites devuelven un 400 que indica el límite
Devuelve los valores normalizados de inicio y fin, la dirección, los totales exactos en segundos hasta semanas, los meses y años calendario completos, el recuento de días calendario, un desglose calendario con una duración ISO y los resultados de días hábiles. Los detalles de días hábiles incluyen la convención de fin de semana y los recuentos de fines de semana y días festivos omitidos.
El punto final aplica primero los años y los meses, luego las semanas y los días según la hora local del reloj, seguidos de las horas, los minutos y los segundos como tiempo transcurrido La respuesta incluye los componentes aplicados, el resultado en varios formatos, el día de la semana, la marca de tiempo Unix, el estado de ajuste al límite y el estado de ajuste por intervalo de salto del horario de verano
Devuelve la fecha original, si fue un día hábil, el desplazamiento solicitado, la fecha y el día de la semana resultantes, los días naturales transcurridos, la configuración de fin de semana y el recuento de fines de semana y festivos omitidos. Un desplazamiento de cero días devuelve la fecha de inicio sin cambios; la fecha de inicio nunca se cuenta. .
La respuesta incluye el instante UTC y la marca de tiempo Unix, además de los objetos de zona horaria de origen y destino Cada objeto proporciona la fecha y hora local, el valor ISO con desplazamiento, el desplazamiento en minutos, el indicador de horario de verano, la abreviatura y el texto formateado También informa la diferencia de desplazamiento y los indicadores de hora local ambigua o inexistente
Para una fecha devuelve el día de la semana, el día de la semana ISO y la fecha semanal, la semana ISO y el año ISO, el día del año, los días restantes, el trimestre, si es un año bisiesto, los días del mes y del año, si es fin de semana y la marca de tiempo Unix de la medianoche UTC al comienzo de esa fecha
El analizador devuelve la duración original y normalizada, su signo y los componentes separados de años, meses, semanas, días, horas, minutos y segundos. También devuelve el total de segundos. Los totales que incluyen años o meses son aproximados; las semanas, los días y las unidades menores son exactos según las reglas de duración fija. .
Los endpoints de formato devuelven los segundos de entrada la unidad mayor seleccionada la cadena de duración ISO y el desglose de componentes Usan semanas días horas minutos y segundos nunca meses ni años Por ejemplo 5 400 segundos se convierten en PT1H30M y los segundos fraccionarios se redondean a milisegundos
Utiliza cadenas ISO para la interoperabilidad componentes estructurados para los cálculos y la visualización y marcas de tiempo Unix para los sistemas que requieren segundos desde la época Para las duraciones utiliza el valor ISO para el almacenamiento o el transporte y los componentes para las etiquetas que se muestran a los usuarios Comprueba las banderas de aproximación limitación y horario de verano antes de considerar que los resultados son universalmente exactos