{"id":"iso-date-add-years","version":"1.0.0","description":"Add a signed whole-year delta to a YYYY-MM-DD date, clamping the day if 29 February has no match.","supported_operations":["iso date add years","add calendar years to a date","shift date by years"],"unsupported_operations":["add days","add months","add seconds","time zones","fiscal years","datetime with time"],"semantics":["date is a proleptic Gregorian UTC calendar date YYYY-MM-DD with years 0001-9999.","years is a canonical integer string with at most 5 digits excluding sign; -0 is accepted as 0.","The month and day-of-month are kept unchanged except that 29 February is clamped to 28 February when the target year is not a leap year.","The result year must stay in 0001-9999, or the call is rejected.","Output date is zero-padded YYYY-MM-DD."],"limits":{"year_min":1,"year_max":9999,"max_years_digits":5},"pricing":{"status":"unpriced","charge_usd":null},"input_schema":{"type":"object","additionalProperties":false,"required":["date","years"],"properties":{"date":{"type":"string","minLength":10,"maxLength":10,"pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"years":{"type":"string","pattern":"^-?(0|[1-9][0-9]*)$","maxLength":6}}},"output_schema":{"type":"object","additionalProperties":false,"required":["date"],"properties":{"date":{"type":"string","minLength":10,"maxLength":10}}},"examples":[{"input":{"date":"2026-09-15","years":"1"},"output":{"date":"2027-09-15"}},{"input":{"date":"2024-02-29","years":"1"},"output":{"date":"2025-02-28"}}],"execute_url":"/v1/tools/iso-date-add-years/versions/1.0.0/execute"}