---
title: "Calculadora de Dias entre Datas (Total e Úteis)"
method: POST
path: "/api/v1/calc/dias-entre-datas"
tags: ["calc", "educacao"]
---

# Calculadora de Dias entre Datas (Total e Úteis)

`POST /api/v1/calc/dias-entre-datas`

## Request

- Base URL: `https://api.calculas.com.br`
- URL: `https://api.calculas.com.br/api/v1/calc/dias-entre-datas`
- Auth: HTTP bearer

Calcula dias corridos e dias úteis (excluindo finais de semana) entre duas datas. Útil para prazos, vencimentos, planejamento.

## Request body

- object
  - `dataInicio` string, required: Data de início do período, no formato AAAA-MM-DD. Exemplo: 2026-01-01 para 1º de janeiro de 2026.
  - `dataFim` string, required: Data de fim do período, no formato AAAA-MM-DD. Exemplo: 2026-12-31 para 31 de dezembro de 2026. Deve ser igual ou posterior à data de início.
  - `diasUteisApenas` boolean: Se verdadeiro (true), o resultado principal mostra apenas dias úteis (excluindo sábados e domingos). Se falso (false), conta todos os dias corridos do período. Padrão: false (dias corridos).
  - `currentDate` string, date-time: ISO-8601 com offset. Default: tempo do servidor. Use pra reprodutibilidade / cache semantico.

## Response `200`

OK

- object
  - `ok` true, required
  - `data` object, required: Resultado dependente da calc — ver schema individual
  - `meta` object

## Other responses

- `422`: Input invalido (Zod parse falhou)
- `500`: Engine error

---

[API](https://skmtc.dev/calculas/apis/contai-api.md) · [All operations](https://skmtc.dev/calculas/apis/contai-api/llms.txt) · [OpenAPI document](https://skmtc.dev/calculas/apis/contai-api/revisions/26a00749292b?raw)