{
  "id": "date-difference-calculator",
  "version": "1.0.0",
  "name": "Date Difference Calculator",
  "shortName": "Date difference",
  "description": "Find the exact calendar difference and total days between two dates.",
  "category": "Date & Time",
  "categorySlug": "date-time",
  "keywords": [
    "days between dates",
    "calendar difference",
    "weeks between dates",
    "date span"
  ],
  "status": "live",
  "workStatus": "pending",
  "reviewStatus": "pending",
  "migrationStatus": "new",
  "engine": "native",
  "creator": null,
  "reviewer": null,
  "quality": {
    "availability": "live",
    "technicalReviewRecord": "/reviews/date-difference-calculator.json",
    "qualifiedReview": "pending",
    "qualifiedReviewer": null,
    "qualifiedReviewDate": null,
    "formulaVersion": "1.0.0",
    "referenceCoverage": "references-pending",
    "releaseTestScope": "Catalog and regression checks are not a professional formula audit; consult release evidence.",
    "historicalMetadataDate": "2026-08-18",
    "historicalMetadataNotice": "The imported date is not evidence of a completed human review."
  },
  "urls": {
    "page": "/calculator/date-difference-calculator/",
    "definition": "/calculator/date-difference-calculator/definition.json",
    "schema": "/calculator/date-difference-calculator/schema.json",
    "llms": "/calculator/date-difference-calculator/llms.txt",
    "legacyDefinition": "/calculator/date-difference-calculator.json"
  },
  "queryExample": "https://askcalculators.com/calculator/date-difference-calculator/?startDate=2026-01-01&endDate=2026-08-18",
  "queryParameters": {
    "startDate": {
      "label": "Start date",
      "type": "date",
      "required": true,
      "default": "2026-01-01"
    },
    "endDate": {
      "label": "End date",
      "type": "date",
      "required": true,
      "default": "2026-08-18"
    }
  },
  "inputs": [
    {
      "id": "startDate",
      "label": "Start date",
      "type": "date",
      "required": true,
      "defaultValue": "2026-01-01",
      "width": "half"
    },
    {
      "id": "endDate",
      "label": "End date",
      "type": "date",
      "required": true,
      "defaultValue": "2026-08-18",
      "width": "half"
    }
  ],
  "outputs": [
    {
      "id": "exactDifference",
      "label": "Exact difference",
      "format": "text",
      "primary": true
    },
    {
      "id": "totalDays",
      "label": "Total days",
      "format": "integer"
    },
    {
      "id": "weeksAndDays",
      "label": "Weeks and days",
      "format": "text"
    },
    {
      "id": "averageMonths",
      "label": "Average months",
      "format": "number",
      "digits": 2
    }
  ],
  "formula": {
    "expression": "Exact difference uses calendar years, months, and remaining days"
  },
  "examples": [
    {
      "label": "Reproducible default-input example (not a personal recommendation)",
      "inputs": {
        "startDate": "2026-01-01",
        "endDate": "2026-08-18"
      }
    }
  ],
  "sources": []
}