{
  "name": "time.diff",
  "group": "time",
  "summary": "Duration between two dates, in every unit.",
  "description": "Computes the elapsed time between two instants: exact totals in each unit, a calendar breakdown (years/months/days rather than 'thirteen and a half months'), the count of weekdays in between, and a human phrase. Negative when `to` precedes `from`.",
  "keywords": [
    "date difference",
    "days between",
    "age calculator",
    "duration",
    "how long until",
    "business days"
  ],
  "endpoint": "https://fluentedi.com/v1/time/diff",
  "mcp_name": "time_diff",
  "makes_network_request": false,
  "parameters": {
    "type": "object",
    "properties": {
      "from": {
        "description": "Start instant: ISO 8601, unix timestamp, or \"now\".",
        "type": "string",
        "default": "now",
        "examples": [
          "1990-05-14"
        ]
      },
      "to": {
        "description": "End instant: ISO 8601, unix timestamp, or \"now\".",
        "type": "string",
        "default": "now"
      },
      "timezone": {
        "description": "IANA timezone identifier, e.g. \"UTC\", \"America/New_York\", \"Asia/Kolkata\", \"Europe/London\".",
        "type": "string",
        "default": "UTC",
        "examples": [
          "America/New_York"
        ]
      }
    },
    "required": [],
    "additionalProperties": false
  },
  "examples": [
    {
      "description": "Days until a deadline",
      "url": "https://fluentedi.com/v1/time/diff?to=2026-12-31",
      "args": {
        "to": "2026-12-31"
      }
    },
    {
      "description": "Exact age from a birth date",
      "url": "https://fluentedi.com/v1/time/diff?from=1990-05-14&to=now",
      "args": {
        "from": "1990-05-14",
        "to": "now"
      }
    },
    {
      "description": "Working days in a sprint",
      "url": "https://fluentedi.com/v1/time/diff?from=2026-08-03&to=2026-08-14",
      "args": {
        "from": "2026-08-03",
        "to": "2026-08-14"
      }
    }
  ],
  "suggestion": null
}