Libera.Date.Api es un motor de cálculo de fechas de alta precisión diseñado para optimizar la lógica empresarial en aplicaciones globales Su principal fortaleza radica en su avanzado Sistema de Días Laborales que calcula con precisión los días hábiles al excluir automáticamente los fines de semana y los días festivos en múltiples países incluyendo 100 países Más allá de simples verificaciones de duración la API ofrece herramientas de programación inteligentes como encontrar el día hábil disponible más cercano analizar rangos de fechas para intervalos no laborables y distinguir entre fines de semana estándar y días festivos legales Ya sea que esté calculando SLAs planificando ventanas de entrega o construyendo listas de recursos humanos Libera.Date.Api asegura que sus fechas estén alineadas con los calendarios empresariales del mundo real
Healthy
curl --location --request GET 'https://zylalabs.com/api/11640/edit+libera+date+and+buisness+days+calculator+api/21974/health' --header 'Authorization: Bearer YOUR_API_KEY'
{"date":"2026-01-06T00:00:00","isWorkingDay":false,"nearestWorkingDay":"2026-01-07T00:00:00"}
curl --location --request GET 'https://zylalabs.com/api/11640/edit+libera+date+and+buisness+days+calculator+api/21978/is+working+day?Date=2026-01-06&countryCode=Required' --header 'Authorization: Bearer YOUR_API_KEY'
{"date":"2026-01-06T00:00:00","nearestWorkingDay":"2026-01-07T00:00:00","isSameDay":false}
curl --location --request GET 'https://zylalabs.com/api/11640/edit+libera+date+and+buisness+days+calculator+api/21981/nearest+working+day?Date=2026-01-06&countryCode=Required' --header 'Authorization: Bearer YOUR_API_KEY'
{"date":"2026-01-06T00:00:00","isNonWorkingDay":true,"type":"holiday","weekendDayNumber":null,"holiday":{"englishName":"Epiphany","localName":"Święto Trzech Króli"}}
curl --location --request GET 'https://zylalabs.com/api/11640/edit+libera+date+and+buisness+days+calculator+api/21982/non+working+day+info?Date=2026-01-06&countryCode=Required' --header 'Authorization: Bearer YOUR_API_KEY'
{"start":"2026-01-01T00:00:00","end":"2026-01-31T00:00:00","workingDays":[{"date":"2026-01-02T00:00:00"},{"date":"2026-01-05T00:00:00"},{"date":"2026-01-07T00:00:00"},{"date":"2026-01-08T00:00:00"},{"date":"2026-01-09T00:00:00"},{"date":"2026-01-12T00:00:00"},{"date":"2026-01-13T00:00:00"},{"date":"2026-01-14T00:00:00"},{"date":"2026-01-15T00:00:00"},{"date":"2026-01-16T00:00:00"},{"date":"2026-01-19T00:00:00"},{"date":"2026-01-20T00:00:00"},{"date":"2026-01-21T00:00:00"},{"date":"2026-01-22T00:00:00"},{"date":"2026-01-23T00:00:00"},{"date":"2026-01-26T00:00:00"},{"date":"2026-01-27T00:00:00"},{"date":"2026-01-28T00:00:00"},{"date":"2026-01-29T00:00:00"},{"date":"2026-01-30T00:00:00"}],"nonWorkingDays":[{"date":"2026-01-01T00:00:00","type":"holiday","englishName":"New Year's Day","localName":"Nowy Rok"},{"date":"2026-01-03T00:00:00","type":"weekend","weekendDayNumber":1},{"date":"2026-01-04T00:00:00","type":"weekend","weekendDayNumber":2},{"date":"2026-01-06T00:00:00","type":"holiday","englishName":"Epiphany","localName":"Święto Trzech Króli"},{"date":"2026-01-10T00:00:00","type":"weekend","weekendDayNumber":1},{"date":"2026-01-11T00:00:00","type":"weekend","weekendDayNumber":2},{"date":"2026-01-17T00:00:00","type":"weekend","weekendDayNumber":1},{"date":"2026-01-18T00:00:00","type":"weekend","weekendDayNumber":2},{"date":"2026-01-24T00:00:00","type":"weekend","weekendDayNumber":1},{"date":"2026-01-25T00:00:00","type":"weekend","weekendDayNumber":2},{"date":"2026-01-31T00:00:00","type":"weekend","weekendDayNumber":1}]}
curl --location --request GET 'https://zylalabs.com/api/11640/edit+libera+date+and+buisness+days+calculator+api/21983/workingdays++range?Start=2026-01-01&End=2026-01-31&countryCode=Required' --header 'Authorization: Bearer YOUR_API_KEY'
{"totalDays":366,"workingDays":251}
curl --location --request GET 'https://zylalabs.com/api/11640/edit+libera+date+and+buisness+days+calculator+api/21973/workingdays+count?Start=2025-01-01&End=2026-01-01&countryCode=Required' --header 'Authorization: Bearer YOUR_API_KEY'
{"totalDays":366,"offDays":115}
curl --location --request GET 'https://zylalabs.com/api/11640/edit+libera+date+and+buisness+days+calculator+api/21975/off-days?Start=2025-01-01&End=2026-01-01&countryCode=Required' --header 'Authorization: Bearer YOUR_API_KEY'
{"totalDays":366,"weekendDaysCount":104}
curl --location --request GET 'https://zylalabs.com/api/11640/edit+libera+date+and+buisness+days+calculator+api/21976/weekend+count?Start=2025-01-01&End=2026-01-01&countryCode=Required' --header 'Authorization: Bearer YOUR_API_KEY'
{"count":15,"holidays":[{"date":"2025-01-01T00:00:00","englishName":"New Year's Day","localName":"Nowy Rok"},{"date":"2025-01-06T00:00:00","englishName":"Epiphany","localName":"Święto Trzech Króli"},{"date":"2025-04-20T00:00:00","englishName":"Easter Sunday","localName":"Wielkanoc"},{"date":"2025-04-21T00:00:00","englishName":"Easter Monday","localName":"Drugi Dzień Wielkanocy"},{"date":"2025-05-01T00:00:00","englishName":"May Day","localName":"Święto Pracy"},{"date":"2025-05-03T00:00:00","englishName":"Constitution Day","localName":"Święto Narodowe Trzeciego Maja"},{"date":"2025-06-08T00:00:00","englishName":"Pentecost","localName":"Zielone Świątki"},{"date":"2025-06-19T00:00:00","englishName":"Corpus Christi","localName":"Boże Ciało"},{"date":"2025-08-15T00:00:00","englishName":"Assumption Day","localName":"Wniebowzięcie Najświętszej Maryi Panny"},{"date":"2025-11-01T00:00:00","englishName":"All Saints' Day","localName":"Wszystkich Świętych"},{"date":"2025-11-11T00:00:00","englishName":"Independence Day","localName":"Narodowe Święto Niepodległości"},{"date":"2025-12-24T00:00:00","englishName":"Christmas Eve","localName":"Wolna Wigilia"},{"date":"2025-12-25T00:00:00","englishName":"Christmas Day","localName":"Boże Narodzenie"},{"date":"2025-12-26T00:00:00","englishName":"St. Stephen's Day","localName":"Drugi Dzień Bożego Narodzenia"},{"date":"2026-01-01T00:00:00","englishName":"New Year's Day","localName":"Nowy Rok"}]}
curl --location --request GET 'https://zylalabs.com/api/11640/edit+libera+date+and+buisness+days+calculator+api/21977/public+holidays?Start=2025-01-01&End=2026-01-01&countryCode=Required' --header 'Authorization: Bearer YOUR_API_KEY'
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 Edita el Calculador de Fechas Libres 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.
(Ahorra 2 meses pagando anualmente 🎉)
Time is money, but calculating it correctly is harder than it looks. Libera.Date.Api is the ultimate solution for developers building HR systems, logistics platforms, and financial applications.
Stop wrestling with leap years, timezone anomalies, and shifting public holidays. Powered by the industry-standard NodaTime engine and our proprietary Working Days System, this API delivers:
Global Awareness: Built-in support for major economies (US, UK, DE, PL, FR) with accurate holiday calendars.
Business Logic Ready: Instantly calculate SLAs and delivery dates by excluding weekends and holidays.
Precision Engineering: Get exact durations down to the minute, or broad calendar period differences (Years/Months/Days).
Smart Fallbacks: Automatically find the next available working day when deadlines hit a holiday.
All requests must be authenticated. You can use either an API Key or a Bearer Token.
| Method | Header Name | Value Format |
|---|---|---|
| API Key | X-Api-Key |
YOUR_API_KEY |
| Bearer Token | Authorization |
Bearer YOUR_JWT_TOKEN |
Base URL: http://localhost:8080 (adjust to your deployment)
Calculates the calendar difference (Years, Months, Days).
URL: /date-calculator/period/date
Method: GET
Parameters:
Start (query, required): Start date (ISO 8601, e.g., 2024-01-01)
End (query, required): End date (ISO 8601, e.g., 2025-03-15)
Request:
curl -X GET "http://localhost:8080/date-calculator/period/date?Start=2024-01-01&End=2025-03-15" \
-H "X-Secret: TEST_SECRET"
Response (200 OK):
{
"years": 1,
"months": 2,
"days": 14,
"description": "1 year, 2 months, 14 days"
}
Calculates the duration in total days, hours, and minutes.
URL: /date-calculator/period/time
Method: GET
Parameters:
Start (query): 2024-01-01T12:00:00
End (query): 2024-01-05T18:30:00
Request:
curl -X GET "<http://localhost:8080/date-calculator/period/time?Start=2024-01-01T12:00:00&End=2024-01-05T18:30:00>" \
-H "X-Secret: TEST_SECRET"
Response (200 OK):
{
"totalDays": 4,
"hours": 102,
"minutes": 6150
}
Advanced logic for business days, weekends, and public holidays.
Path Parameter: {countryCode} (e.g., PL, US, DE, UK).
Checks if a specific date is a working day. If it is not (due to weekend or holiday), it returns the date of the next immediate working day.
URL: GET /workingdays/{countryCode}/is-working-day
Parameters:
Date (required, YYYY-MM-DD)
Example Request (Checking Christmas Day in US):
bash
curl -X GET "http://localhost:8080/workingdays/US/is-working-day?Date=2025-12-25"
Response (200 OK):
json{
"date": "2025-12-25T00:00:00",
"isWorkingDay": false,
"nearestWorkingDay": "2025-12-26T00:00:00"
}
Returns detailed metadata about why a day is not a working day. It distinguishes between weekends (specifying if it's the 1st or 2nd day of the weekend) and public holidays.
URL: GET /workingdays/{countryCode}/non-working-info
Parameters:
Date (required, YYYY-MM-DD)
Example Request:
bash
curl -X GET "http://localhost:8080/workingdays/PL/non-working-info?Date=2024-05-01"
Response (200 OK):
json{
"date": "2024-05-01T00:00:00",
"isNonWorkingDay": true,
"type": "holiday",
"weekendDayNumber": null,
"holiday": {
"englishName": "Labor Day",
"localName": "Święto Pracy"
}
}
Generates a comprehensive breakdown of a date range, splitting all dates into "Working" and "Non-Working" lists. Ideal for rendering calendars or Gantt charts.
URL: GET /workingdays/{countryCode}/range
Parameters:
Start (required): Range start.
End (required): Range end.
Note: Max range is limited by server configuration (default 366 days).
Example Request:
bash
curl -X GET "http://localhost:8080/workingdays/US/range?Start=2024-07-03&End=2024-07-05"
Response (200 OK):
json{
"start": "2024-07-03T00:00:00",
"end": "2024-07-05T00:00:00",
"workingDays": [
{ "date": "2024-07-03T00:00:00" },
{ "date": "2024-07-05T00:00:00" }
],
"nonWorkingDays": [
{
"date": "2024-07-04T00:00:00",
"type": "holiday",
"englishName": "Independence Day",
"localName": "Independence Day"
}
]
}
Calculates the number of business days between two dates. (excluding weekends and holidays).
URL: /workingdays/{countryCode}/count
Method: GET
Parameters:
Start (query): 2024-05-01
End (query): 2024-05-10
Request:
curl -X GET "<http://localhost:8080/workingdays/PL/count?Start=2024-05-01&End=2024-05-10>" \
-H "X-Secret: TEST_SECRET"
Response (200 OK):
{
"totalDays": 366,
"workingDays": 253
}
Returns the count of non-working days (weekends + holidays).
URL: /workingdays/{countryCode}/off-days
Method: GET
Request:
curl -X GET "<http://localhost:8080/workingdays/PL/off-days?Start=2024-05-01&End=2024-05-10>" \
-H "X-Secret: TEST_SECRET"
Response (200 OK):
{
"totalDays": 366,
"offDays": 113
}
Returns a list of public holidays in the given range.
URL: /workingdays/{countryCode}/holidays
Method: GET
Request:
curl -X GET "<http://localhost:8080/workingdays/PL/holidays?Start=2024-01-01&End=2024-01-10>" \
-H "X-Secret: TEST_SECRET"
Response (200 OK):
[
{
"date": "2024-01-01",
"name": "New Year's Day",
"localName": "Nowy Rok"
},
{
"date": "2024-01-06",
"name": "Epiphany",
"localName": "Święto Trzech Króli"
}
]
Returns the number of weekend days (Saturdays and Sundays).
URL: /workingdays/{countryCode}/weekends
Method: GET
Request:
curl -X GET "<http://localhost:8080/workingdays/PL/weekends?Start=2024-05-01&End=2024-05-10>" \
-H "X-Secret: TEST_SECRET"
Response (200 OK):
{
"totalDays": 91,
"weekendDaysCount": 26
}
Cada punto final devuelve datos JSON adaptados a cálculos de fechas específicos Por ejemplo el punto final "Contar Días Laborales" devuelve el número total de días hábiles entre dos fechas mientras que el punto final "Listar Días Festivos" proporciona detalles sobre días festivos dentro de un rango especificado
Los campos clave varían según el punto final Por ejemplo el punto final "Obtener conteo de días libres" devuelve "totalDays" y "offDays" mientras que "Obtener información detallada sobre días no laborables" incluye "date" "isNonWorkingDay" y detalles de "holiday" como "englishName" y "localName"
Los parámetros difieren según el punto final Por ejemplo el punto final "Verificar Día Laboral" requiere un parámetro "Fecha" mientras que el punto final "Analizar Rango" necesita fechas de "Inicio" y "Fin" Cada parámetro debe seguir formatos específicos como AAAA-MM-DD para las fechas
Los datos de respuesta están estructurados en formato JSON, conteniendo típicamente un objeto principal con campos relevantes. Por ejemplo, el punto final "Analizar Rango" devuelve "díasLaborales" y "díasNoLaborales" como arreglos de objetos de fecha, lo que facilita su análisis y utilización
La API utiliza el motor NodaTime estándar de la industria y algoritmos patentados para garantizar cálculos de fechas precisos. Los datos sobre días festivos y fines de semana se obtienen de calendarios nacionales fiables de más de 100 países
Los casos de uso comunes incluyen calcular los SLA planificar horarios de entrega y gestionar listas de recursos humanos Por ejemplo las empresas pueden utilizar el punto final "Contar Días Laborales" para determinar plazos teniendo en cuenta los días festivos y los fines de semana
Los usuarios pueden personalizar las solicitudes especificando parámetros como rangos de fechas y códigos de país Por ejemplo al usar el extremo "Listar Días Festivos Públicos" los usuarios pueden definir las fechas de "Inicio" y "Fin" para recuperar los días festivos relevantes para su marco de tiempo específico
Los usuarios pueden aprovechar las respuestas JSON estructuradas para integrar cálculos de fechas en aplicaciones. Por ejemplo, la respuesta "Obtener conteo de fines de semana" se puede utilizar para ajustar los plazos de los proyectos teniendo en cuenta los días no laborables en el software de programación
El endpoint "Contar Días de Descanso" proporciona el número total de días no laborables dentro de un rango de fechas específico, incluyendo tanto los fines de semana como los días festivos. Esto ayuda a las empresas a entender el posible tiempo de inactividad durante un período determinado
Puedes usar el endpoint "Verificar Día Laboral y Encontrar el Más Cercano". Al proporcionar una fecha, la API devolverá si es un día laborable y, si no, el siguiente día laborable más cercano, lo que permite una programación efectiva
El endpoint "Analizar Rango" permite analizar un rango de fechas máximo de 366 días, según lo configurado por la configuración del servidor. Esto es útil para generar listas completas de días laborables y no laborables durante un año
La API incluye soporte integrado para más de 100 países utilizando calendarios nacionales confiables para reflejar con precisión los días festivos públicos Esto asegura que los cálculos de días hábiles sean precisos y relevantes para el país especificado
La respuesta incluye campos como "fecha", "esDíaLaboral" (booleano) y "díaLaboralMásCercano" (fecha) Esta estructura permite a los usuarios evaluar rápidamente el estado de una fecha y planificar en consecuencia
Utilice el endpoint "List Public Holidays" especificando el código del país y el rango de fechas deseado La respuesta incluirá un array de festivos detallando la fecha y el nombre de cada festivo lo cual es esencial para planificar alrededor de los días no laborables
Este endpoint devuelve metadatos detallados sobre por qué una fecha específica no es laborable incluyendo si es un fin de semana o un día festivo junto con el nombre del festivo tanto en inglés como en el idioma local mejorando la claridad para los usuarios
El endpoint "Contar Días Laborales" devuelve el número total de días hábiles entre dos fechas, excluyendo fines de semana y días festivos. Estos datos se pueden usar para establecer plazos realistas y gestionar las cronologías de proyectos de manera efectiva