Calculadora duración barra Gantt

Esta calculadora de duración de barra Gantt acepta una fecha ISO de inicio, una de fin y un indicador opcional working_days_only; devuelve el recuento inclusivo de días de calendario, el de laborables de lunes a viernes, los fines de semana dentro de la barra, el día de la semana de ambos extremos y un único valor duration_days según el modo que usted elija. Las barras que terminan antes de empezar se rechazan con invalid_input.

Cómo se cuenta la duración de la barra Gantt (calendario inclusivo frente a laborables)

El modo calendario fija duration_days al número inclusivo de días gregorianos entre inicio y fin, es decir el serial de fin menos el de inicio más uno. La respuesta informa siempre ambas métricas: calendar_days_inclusive, working_days_inclusive y weekend_days_inclusive igual a su diferencia, más duration_days igual a la métrica elegida con working_days_only.

Contrato de entrada, campos de respuesta y reglas de validación

Los años deben estar entre uno y nueve mil novecientos noventa y nueve. Si end es estrictamente anterior a start, el manejador rechaza la petición con un mensaje claro de que una barra Gantt no puede terminar antes de empezar; esos fallos no se facturan. Combine los números con su propio renderizador de gráficos si necesita anchos en píxeles; este extremo solo calcula recuentos de días y no dibuja SVG ni emite nombres de tarea. Envíe por POST un objeto JSON con los campos de cadena obligatorios start y end en forma estricta YYYY-MM-DD, por ejemplo 2024-01-08 y 2024-01-19. El opcional working_days_only vale false por defecto; envíe true, false o formas habituales como yes y no. Se aceptan los alias start_date, from, begin, end_date, to, finish, workdays_only y business_days_only para que los importadores desde hojas de cálculo y exportaciones de PM renombren menos campos. Cada fecha se valida como día real del calendario gregoriano: valores imposibles como 2023-02-29 o 2024-04-31 fallan con invalid_input nombrando el campo. En éxito el cuerpo repite start y end normalizados, start_weekday y end_weekday en inglés, calendar_days_inclusive, working_days_inclusive, weekend_days_inclusive, el booleano working_days_only, count_mode como calendar o working, duration_days como la longitud elegida y una cadena formula breve que documenta la regla inclusiva de JDN. Ejemplo: start 2024-01-08 lunes hasta end 2024-01-19 viernes da doce días de calendario, diez laborables, dos de fin de semana, y duration_days doce en modo calendario o diez cuando working_days_only es true.

Dónde aporta valor una API de duración de barra Gantt

Los paneles de cartera que importan exportaciones CSV de líneas de tiempo de Microsoft Project, Smartsheet o Jira suelen necesitar una comprobación de segunda fuente de la longitud de la barra antes de pintar mapas de calor de capacidad. Los equipos de contratación comparan el tramo de calendario con el laborable al redactar hitos que deben excluir sábados y domingos. Fechas inválidas y rangos invertidos no consumen saldo. Los planificadores de recursos convierten duration_days en persona-días cuando working_days_only es true para que el relleno de fin de semana del diagrama no infle la plantilla. Como la implementación es parse de nivel A, cada llamada exitosa cuesta el precio base publicado $0.002 sin tokens de modelo ni red de salida. Mantenga las entradas como cadenas de calendario ISO, fije duration_days y los desgloses inclusivos en las pruebas, y obtendrá longitudes de barra reproducibles para auditorías de plan, demos de landing SEO y edge workers sin montar una base de datos completa de gestión de proyectos propia.