{
"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}'
Após se cadastrar, cada desenvolvedor recebe uma chave de acesso à API pessoal, uma combinação única de letras e dígitos para acessar nosso endpoint de API. Para autenticar com a Diferença entre datas e dias úteis API basta incluir seu token Bearer no cabeçalho Authorization.
| Cabeçalho | Descrição |
|---|---|
Authorization
|
Obrigatório
Deve ser Bearer access_key. Veja "Sua chave de acesso à API" acima quando você estiver inscrito.
|
Sem compromisso de longo prazo. Faça upgrade, downgrade ou cancele a qualquer momento. O teste gratuito inclui até 50 requisições.
Diferenças entre datas, dias úteis com fins de semana e feriados personalizados, cálculo de duração com ajuste para o fim do mês, conversão de fuso horário, informações sobre semanas ISO e durações ISO 8601
Por padrão, a contagem inclui os dias úteis após a data inicial, até e incluindo a data final. Portanto, a diferença de segunda a sexta-feira é 4, e adicionar 4 dias úteis a segunda-feira resulta em sexta-feira, então a diferença e a adição coincidem. Defina includeStart como true para também contar a data inicial, como na função NETWORKDAYS das planilhas.
Sim Passe weekendDays como números de 0 a 6 (0 = domingo) ou nomes como "Fri" e "Sat" Passe holidays como até 366 datas no formato YYYY-MM-DD A API não inclui um calendário de feriados integrado então você envia as datas que se aplicam a você
O resultado é ajustado para o último dia válido do mês de destino: 2025-02-28 ou 2024-02-29 em um ano bissexto. A resposta define clamped como true quando isso acontece. 29 de fevereiro mais um ano resulta em 28 de fevereiro. .
Passe um fuso horário IANA para diff ou add. Dias e meses mantêm a hora do relógio, e horas, minutos e segundos representam tempo decorrido exato. O dia da mudança para o horário de verão em Nova York tem 1 dia de calendário, mas 23 horas. Horários locais inexistentes avançam pelo intervalo da mudança, e horários locais repetidos são resolvidos para o instante anterior. Ambos os casos são sinalizados. .
Datas ISO 8601 (AAAA-MM-DD) e datas e horas (AAAA-MM-DDTHH:MM[:SS[.fff]]) com um deslocamento Z ou mais/menos HH:MM opcional, para anos de 0001 a 9999. Valores sem deslocamento são interpretados no fuso horário timeZone quando você o informa, caso contrário, como UTC. Datas inválidas, como 2026-02-29, retornam um erro 400 com uma mensagem clara. .
Anos e meses variam de duração, então o parse-duration usa médias para eles (365,2425 dias por ano, 30,436875 dias por mês) e define totalSecondsApproximate como verdadeiro. Para obter um resultado exato, adicione a duração a uma data inicial real com o endpoint add
A semana ISO 8601: as semanas começam na segunda-feira, e a semana 1 contém a primeira quinta-feira do ano. Por exemplo, 2021-01-03 está na semana 53 do ano semanal de 2020. A resposta inclui tanto isoWeek quanto isoWeekYear. .
Os intervalos e deslocamentos podem ser de até 200 anos, as listas de feriados podem conter até 366 datas, os incrementos de dias úteis podem ser de até mais ou menos 50.000 e os corpos das solicitações podem ter até 32 KiB. As solicitações que excederem esses limites retornam um erro 400 que especifica o limite. .
Retorna os valores normalizados de início e fim, a direção, os totais exatos em segundos até semanas, meses e anos civis completos, a contagem de dias civis, uma divisão civil com uma duração ISO e os resultados dos dias úteis. Os detalhes dos dias úteis incluem a convenção de fim de semana e as contagens de fins de semana e feriados ignorados.
O endpoint aplica primeiro anos e meses, depois semanas e dias usando o relógio local, seguidos de horas, minutos e segundos como tempo decorrido. A resposta inclui os componentes aplicados, o resultado em vários formatos, o dia da semana, o timestamp Unix, o status de limitação e o status de ajuste de lacuna de horário de verão
Retorna a data original, se era um dia útil, o deslocamento solicitado, a data resultante e o dia da semana, os dias corridos abrangidos, a configuração dos fins de semana e a quantidade de fins de semana e feriados ignorados. Um deslocamento de zero dias retorna a data inicial sem alterações; a data inicial nunca é contabilizada.
A resposta inclui o instante UTC e o carimbo de data/hora Unix, além dos objetos de fuso horário de origem e destino Cada objeto fornece a data e hora locais, o valor ISO com deslocamento, o deslocamento em minutos, o indicador de horário de verão, a abreviatura e o texto formatado Também informa a diferença de deslocamento e os indicadores de horário local ambíguo ou inexistente
Para uma data, retorna o dia da semana, o dia da semana ISO e a data da semana, a semana ISO e o ano da semana, o dia do ano, os dias restantes, o trimestre, se é ano bissexto, os dias do mês e do ano, se é fim de semana e o carimbo de data/hora Unix da meia-noite UTC no início dessa data
O analisador retorna a duração original e normalizada, seu sinal e os componentes separados de anos, meses, semanas, dias, horas, minutos e segundos Também retorna o total de segundos Os totais que envolvem anos ou meses são aproximados; semanas, dias e unidades menores são exatos segundo regras de duração fixa .
Os endpoints de formatação retornam os segundos de entrada a maior unidade selecionada a string de duração ISO e a decomposição em componentes Eles usam semanas dias horas minutos e segundos nunca meses ou anos Por exemplo 5 400 segundos se tornam PT1H30M e os segundos fracionários são arredondados para milissegundos
Use strings ISO para interoperabilidade componentes estruturados para cálculos e exibição e timestamps Unix para sistemas que exigem segundos desde a época Para durações use o valor ISO para armazenamento ou transporte e componentes para rótulos exibidos ao usuário Verifique as flags de aproximação limitação e horário de verão antes de tratar os resultados como universalmente exatos