{"success":true,"version":"v1","request":{"tool":"get_calculator_schema","calculator_id":"chinese-festivals"},"result":{"entity_type":"calculator","id":"chinese-festivals","calculator_id":"chinese-festivals","canonical_url":"https://tttkmbb.com/lunar/chinese-festivals","name":"Chinese Festival Dates Calculator","title":"Chinese Festival Dates – Traditional Festivals, 三伏 Dog Days and 数九 Winter Periods for Any Year","category":"lunar","category_name":"Chinese Calendar","tool_name":"list_chinese_festivals","featured_mcp_tool":false,"description":"Lists the Gregorian dates of the traditional Chinese festivals falling in a Gregorian year (春节, 元宵节, 龙抬头, 上巳节, 清明节, 端午节, 七夕, 中元节, 中秋节, 重阳节, 寒衣节, 下元节, 冬至, 腊八节, 小年, 除夕), the three 伏 periods (三伏 sanfu) counted by 庚 days from the summer solstice, and the nine 数九 (shujiu) periods from the winter solstice.","use_when":"You need the date of a Chinese festival, Chinese New Year's Eve, the dog days (三伏) or the 数九 cold periods in a given year, e.g. for planning or a calendar.","do_not_use_when":"You need the festival on one specific date (use lunar-calendar-converter), a single lunar date's Gregorian equivalent (use lunar-to-solar), or Western movable feasts (use easter-date).","inputs":[{"name":"year","label":"Gregorian year","type":"integer","required":true,"min":1900,"max":2100,"description":"Gregorian calendar year (1900–2100).","example":2024}],"outputs":[{"name":"festivals","label":"Festivals","type":"list","decimals":4,"description":"Rows in date order: name_cn, name_en, lunar_or_solar_rule, gregorian_date, weekday. 12th-month festivals belong to the previous lunar year; in some years 腊八 occurs twice or not at all within the Gregorian year."},{"name":"chinese_new_year","label":"Chinese New Year (春节)","type":"date","decimals":4,"description":"正月初一 of the lunar year starting in this Gregorian year."},{"name":"chinese_new_year_eve","label":"New Year's Eve (除夕)","type":"date","decimals":4,"description":"Last day of the previous lunar year (the day before Chinese New Year)."},{"name":"dragon_boat_festival","label":"Dragon Boat Festival (端午节)","type":"date","decimals":4,"description":"五月初五."},{"name":"mid_autumn_festival","label":"Mid-Autumn Festival (中秋节)","type":"date","decimals":4,"description":"八月十五."},{"name":"lunar_year_span","label":"Lunar year","type":"string","decimals":4,"description":"Ganzhi, animal and Gregorian span of the lunar year that starts in this Gregorian year."},{"name":"sanfu","label":"三伏 (dog days)","type":"object","decimals":4,"description":"first_fu_start (初伏), mid_fu_start (中伏), mid_fu_days (10 or 20), last_fu_start (末伏), fu_end (出伏, first day after 末伏), total_days, summer_solstice, liqiu."},{"name":"sanfu_text","label":"三伏 summary","type":"string","decimals":4,"description":"The three periods in one line."},{"name":"shujiu","label":"数九 (nine-day cold periods)","type":"list","decimals":4,"description":"9 rows from the winter solstice day: period_cn (一九 … 九九), period, start_date, end_date."}],"input_schema":{"type":"object","properties":{"year":{"description":"Gregorian calendar year (1900–2100).","type":"integer","minimum":1900,"maximum":2100,"examples":[2024]}},"additionalProperties":false,"required":["year"]},"output_schema":{"type":"object","properties":{"festivals":{"description":"Rows in date order: name_cn, name_en, lunar_or_solar_rule, gregorian_date, weekday. 12th-month festivals belong to the previous lunar year; in some years 腊八 occurs twice or not at all within the Gregorian year.","type":"array"},"chinese_new_year":{"description":"正月初一 of the lunar year starting in this Gregorian year.","type":"string","format":"date"},"chinese_new_year_eve":{"description":"Last day of the previous lunar year (the day before Chinese New Year).","type":"string","format":"date"},"dragon_boat_festival":{"description":"五月初五.","type":"string","format":"date"},"mid_autumn_festival":{"description":"八月十五.","type":"string","format":"date"},"lunar_year_span":{"description":"Ganzhi, animal and Gregorian span of the lunar year that starts in this Gregorian year.","type":"string"},"sanfu":{"description":"first_fu_start (初伏), mid_fu_start (中伏), mid_fu_days (10 or 20), last_fu_start (末伏), fu_end (出伏, first day after 末伏), total_days, summer_solstice, liqiu.","type":"object"},"sanfu_text":{"description":"The three periods in one line.","type":"string"},"shujiu":{"description":"9 rows from the winter solstice day: period_cn (一九 … 九九), period, start_date, end_date.","type":"array"}}},"formula":"lunar festivals: Gregorian date of the fixed lunar month/day (regular months only); 清明 and 冬至: solar-term dates; 初伏 = 3rd 庚 day counting from the summer solstice day (inclusive), 中伏 = 4th 庚 day, 末伏 = first 庚 day on/after 立秋, 出伏 = 末伏 + 10 days; 数九: 9 periods of 9 days starting on the winter solstice day","method":"Dates are civil dates at UTC+8. 中伏 lasts 20 days when five 庚 days fall between the summer solstice and 立秋 (30- or 40-day 三伏). The 数九 count starts on the solstice day itself (the common modern rule; some old almanacs start on the first 壬 day after it). Traditional calendar/cultural reference calculation; not a prediction, medical, legal or financial advice.","sources":[{"name":"Chinese calendar (Wikipedia) – calendar rules as standardised in GB/T 33661-2017","url":"https://en.wikipedia.org/wiki/Chinese_calendar","type":"reference","retrieved_at":"2026-09-24"},{"name":"三伏 Sanfu (Chinese Wikipedia)","url":"https://zh.wikipedia.org/wiki/三伏","type":"reference","retrieved_at":"2026-09-24"},{"name":"Hong Kong Observatory – Gregorian-Lunar Calendar Conversion Table","url":"https://www.hko.gov.hk/en/gts/time/conversion.htm","type":"government","retrieved_at":"2026-09-24"}],"freshness":{"type":"static","max_age_seconds":null,"note":"Deterministic formula with fixed constants; results never go stale. Inputs supplied by the caller determine the output."},"examples":[{"name":"2024","inputs":{"year":2024},"expected":{"chinese_new_year":"2024-02-10","dragon_boat_festival":"2024-06-10","mid_autumn_festival":"2024-09-17","chinese_new_year_eve":"2024-02-09","sanfu":{"first_fu_start":"2024-07-15","mid_fu_start":"2024-07-25","mid_fu_days":20,"last_fu_start":"2024-08-14","fu_end":"2024-08-24"}},"url":"https://tttkmbb.com/api/v1/calculate/chinese-festivals?year=2024"},{"name":"2025","inputs":{"year":2025},"expected":{"chinese_new_year":"2025-01-29","dragon_boat_festival":"2025-05-31","mid_autumn_festival":"2025-10-06","sanfu":{"first_fu_start":"2025-07-20","mid_fu_start":"2025-07-30","mid_fu_days":10,"last_fu_start":"2025-08-09"}},"url":"https://tttkmbb.com/api/v1/calculate/chinese-festivals?year=2025"}],"faq":[{"q":"Why are 腊八 and 小年 listed with the previous lunar year?","a":"They fall in the 12th lunar month (腊月), which belongs to the lunar year that started the previous Chinese New Year but is dated in January or February of this Gregorian year. When Chinese New Year is on 21–22 January, 腊八 falls in late December of the previous Gregorian year instead."},{"q":"How are the 三伏 dates counted?","a":"Count 庚 days (every 10th day of the sexagenary day cycle) from the summer solstice, including the solstice itself if it is a 庚 day: the third is 初伏 and the fourth is 中伏; 末伏 starts on the first 庚 day on or after 立秋, so 中伏 lasts 10 or 20 days."},{"q":"Is 清明 a lunar festival?","a":"No. 清明节 is the solar term 清明 (Sun at 15°), which falls on 4–6 April; 冬至 (21–23 December) is likewise a solar-term festival."}],"tags":["chinese festivals","chinese new year date","spring festival","dragon boat festival date","mid-autumn festival date","sanfu"],"related":[{"calculator_id":"lunar-to-solar","reason":"Gregorian date of any other lunar month/day."},{"calculator_id":"solar-terms","reason":"Exact instants of 清明, 夏至, 立秋 and 冬至 used here."},{"calculator_id":"days-until","reason":"Countdown to a festival date."}],"links":{"html":"https://tttkmbb.com/lunar/chinese-festivals","markdown":"https://tttkmbb.com/lunar/chinese-festivals.md","json":"https://tttkmbb.com/lunar/chinese-festivals.json","api":"https://tttkmbb.com/api/v1/calculate/chinese-festivals","schema":"https://tttkmbb.com/api/v1/calculators/chinese-festivals","openapi":"https://tttkmbb.com/openapi.json","mcp":"https://tttkmbb.com/mcp"},"version":"v1","updated_at":"2026-09-24"},"timestamp":"2026-09-24T08:33:13Z","next_actions":[{"tool":"run_calculator","calculator_id":"chinese-festivals","reason":"Run Chinese Festival Dates Calculator with the inputs above."}],"links":{"markdown":"https://tttkmbb.com/lunar/chinese-festivals.md"}}