Day Calculator · Schema
Raw schema.

Same JSON the GET /v1/general-utility/day-calculator/schema endpoint returns — formatted for reading. Use it to codegen typed clients or document the contract.
← Back to tool docs Try it interactively Hit the live endpoint
day-calculator.schema.json
{
  "tool": "day-calculator",
  "domain": "general-utility",
  "version": "1.0.0",
  "name": "Day Calculator",
  "description": "Calculate the exact number of days, weeks, months, or years between two dates, or add/subtract time from a date, with options to exclude weekends and holidays.",
  "standard": null,
  "inputs": [
    {
      "key": "mode",
      "label": "Calculator Mode",
      "help": "Choose between finding the days between two dates, or adding/subtracting days/weeks/months/years from a date.",
      "type": "enum",
      "options": [
        "between",
        "add_subtract"
      ],
      "default": "between"
    },
    {
      "key": "start_date",
      "label": "Start Date",
      "placeholder": "YYYY-MM-DD",
      "help": "Specify the starting date in YYYY-MM-DD format.",
      "type": "string",
      "default": "2026-05-26"
    },
    {
      "key": "end_date",
      "label": "End Date",
      "placeholder": "YYYY-MM-DD",
      "help": "Specify the ending date in YYYY-MM-DD format (used in 'between' mode).",
      "type": "string",
      "default": "2026-12-31"
    },
    {
      "key": "include_start_end_days",
      "label": "Include Both Start/End Dates in Count",
      "help": "If true, adds 1 extra day to count both boundary days in the total.",
      "type": "boolean",
      "default": false
    },
    {
      "key": "operation",
      "label": "Operation",
      "help": "Choose whether to add or subtract duration to the start date (used in 'add_subtract' mode).",
      "type": "enum",
      "options": [
        "add",
        "subtract"
      ],
      "default": "add"
    },
    {
      "key": "years",
      "label": "Years",
      "type": "integer",
      "min": 0,
      "max": 1000,
      "default": 0
    },
    {
      "key": "months",
      "label": "Months",
      "type": "integer",
      "min": 0,
      "max": 12000,
      "default": 0
    },
    {
      "key": "weeks",
      "label": "Weeks",
      "type": "integer",
      "min": 0,
      "max": 52000,
      "default": 0
    },
    {
      "key": "days",
      "label": "Days",
      "type": "integer",
      "min": 0,
      "max": 365000,
      "default": 0
    },
    {
      "key": "holiday_preset",
      "label": "Holiday Calendar Preset",
      "help": "Select a pre-configured country calendar for counting working days and public holidays.",
      "type": "enum",
      "options": [
        "none",
        "us_federal",
        "india_national"
      ],
      "default": "us_federal"
    },
    {
      "key": "exclude_weekends",
      "label": "Exclude Weekends",
      "help": "Exclude Saturday and Sunday from the count in 'between' mode.",
      "type": "boolean",
      "default": false
    },
    {
      "key": "exclude_holidays",
      "label": "Exclude Public Holidays",
      "help": "Exclude holidays of the selected calendar from the count in 'between' mode.",
      "type": "boolean",
      "default": false
    },
    {
      "key": "skip_weekends",
      "label": "Skip Weekends when Adding/Subtracting",
      "help": "If true, added days will only count business days, skipping Saturdays/Sundays (used in 'add_subtract' mode).",
      "type": "boolean",
      "default": false
    },
    {
      "key": "skip_holidays",
      "label": "Skip Holidays when Adding/Subtracting",
      "help": "If true, added days will skip calendar public holidays (used in 'add_subtract' mode).",
      "type": "boolean",
      "default": false
    }
  ],
  "outputs": [
    {
      "key": "verdict",
      "label": "Verdict",
      "type": "string"
    },
    {
      "key": "total_days",
      "label": "Total Calendar Days",
      "type": "integer"
    },
    {
      "key": "working_days",
      "label": "Working Days",
      "type": "integer"
    },
    {
      "key": "weekend_days",
      "label": "Weekend Days",
      "type": "integer"
    },
    {
      "key": "holidays_count",
      "label": "Public Holidays",
      "type": "integer"
    },
    {
      "key": "breakdown",
      "label": "Time Breakdown",
      "type": "string"
    },
    {
      "key": "alternative_units",
      "label": "Alternative Units",
      "type": "string",
      "render": "lines"
    },
    {
      "key": "result_date",
      "label": "Resulting Date",
      "type": "string"
    },
    {
      "key": "holidays_list",
      "label": "Observed Holidays falling in range",
      "type": "string",
      "render": "lines"
    },
    {
      "key": "assumptions_note",
      "label": "Notes",
      "type": "string",
      "render": "lines"
    }
  ],
  "endpoint": "/v1/general-utility/day-calculator"
}