{"success":true,"version":"v1","request":{"tool":"get_calculator_schema","calculator_id":"lunar-to-solar"},"result":{"entity_type":"calculator","id":"lunar-to-solar","calculator_id":"lunar-to-solar","canonical_url":"https://tttkmbb.com/lunar/lunar-to-solar","name":"Lunar to Solar Date Converter","title":"Lunar to Solar Date Converter – Chinese Lunar Date to Gregorian Date with Leap-Month Check","category":"lunar","category_name":"Chinese Calendar","tool_name":"convert_lunar_to_solar","featured_mcp_tool":false,"description":"Converts a Chinese lunar calendar date (year, month, leap-month flag, day) to the Gregorian date, reporting the weekday, the day's ganzhi (干支) and the length of that lunar month, and validating that the leap month and day exist in that year.","use_when":"You know a lunar date such as 八月十五 or 闰六月初一 of a given lunar year and need the Gregorian date (e.g. for a lunar birthday or festival).","do_not_use_when":"You start from a Gregorian date (use lunar-calendar-converter), or you want every festival of a year at once (use chinese-festivals).","inputs":[{"name":"lunar_year","label":"Lunar year","type":"integer","required":true,"min":1900,"max":2100,"description":"Lunar year number (the year that starts at that year's Chinese New Year), 1900–2100.","example":2026},{"name":"lunar_month","label":"Lunar month","type":"integer","required":true,"min":1,"max":12,"description":"Lunar month number 1 (正月) to 12 (腊月).","example":8},{"name":"is_leap_month","label":"Leap month (闰月)","type":"boolean","required":false,"default":false,"description":"true when the date is in the intercalary month of that number (only valid in years that have that leap month).","example":false},{"name":"lunar_day","label":"Lunar day","type":"integer","required":true,"min":1,"max":30,"description":"Day of the lunar month, 1–30 (day 30 exists only in 30-day months).","example":15}],"outputs":[{"name":"gregorian_date","label":"Gregorian date","type":"date","decimals":4,"description":"Gregorian civil date (China Standard Time)."},{"name":"weekday","label":"Weekday","type":"string","decimals":4,"description":"Day of the week."},{"name":"day_ganzhi","label":"Day ganzhi (干支)","type":"string","decimals":4,"description":"Sexagenary day with pinyin, e.g. 壬寅 (Renyin)."},{"name":"month_days","label":"Days in lunar month","type":"integer","decimals":0,"description":"Length of the requested lunar month (29 or 30)."},{"name":"lunar_date_chinese","label":"Lunar date (Chinese)","type":"string","decimals":4,"description":"Written form, e.g. 二〇二六年八月十五."},{"name":"month_name","label":"Month name","type":"string","decimals":4,"description":"Traditional month name, prefixed 闰 for a leap month."},{"name":"year_ganzhi","label":"Year ganzhi","type":"string","decimals":4,"description":"Sexagenary year with pinyin, e.g. 丙午 (Bingwu)."},{"name":"zodiac","label":"Zodiac (生肖)","type":"string","decimals":4,"description":"Zodiac animal of the lunar year."},{"name":"julian_day_number","label":"Julian Day Number","type":"integer","decimals":0,"description":"Julian Day Number of the Gregorian date."},{"name":"leap_month_note","label":"Leap month of the year","type":"string","decimals":4,"description":"Which leap month the lunar year has (if any), so a wrong is_leap_month flag can be corrected."}],"input_schema":{"type":"object","properties":{"lunar_year":{"description":"Lunar year number (the year that starts at that year's Chinese New Year), 1900–2100.","type":"integer","minimum":1900,"maximum":2100,"examples":[2026]},"lunar_month":{"description":"Lunar month number 1 (正月) to 12 (腊月).","type":"integer","minimum":1,"maximum":12,"examples":[8]},"is_leap_month":{"description":"true when the date is in the intercalary month of that number (only valid in years that have that leap month).","type":"boolean","default":false,"examples":[false]},"lunar_day":{"description":"Day of the lunar month, 1–30 (day 30 exists only in 30-day months).","type":"integer","minimum":1,"maximum":30,"examples":[15]}},"additionalProperties":false,"required":["lunar_year","lunar_month","lunar_day"]},"output_schema":{"type":"object","properties":{"gregorian_date":{"description":"Gregorian civil date (China Standard Time).","type":"string","format":"date"},"weekday":{"description":"Day of the week.","type":"string"},"day_ganzhi":{"description":"Sexagenary day with pinyin, e.g. 壬寅 (Renyin).","type":"string"},"month_days":{"description":"Length of the requested lunar month (29 or 30).","type":"integer"},"lunar_date_chinese":{"description":"Written form, e.g. 二〇二六年八月十五.","type":"string"},"month_name":{"description":"Traditional month name, prefixed 闰 for a leap month.","type":"string"},"year_ganzhi":{"description":"Sexagenary year with pinyin, e.g. 丙午 (Bingwu).","type":"string"},"zodiac":{"description":"Zodiac animal of the lunar year.","type":"string"},"julian_day_number":{"description":"Julian Day Number of the Gregorian date.","type":"integer"},"leap_month_note":{"description":"Which leap month the lunar year has (if any), so a wrong is_leap_month flag can be corrected.","type":"string"}}},"formula":"JDN = start of the lunar month (new-moon day at UTC+8) + lunar_day − 1; month numbering per GB/T 33661-2017 (month 11 contains the winter solstice; leap month = first month without a 中气)","method":"Same astronomical calendar core as lunar-calendar-converter, checked against Hong Kong Observatory tables. A leap month that does not exist in the year raises INVALID_PARAMETER; a day beyond the month length raises OUT_OF_RANGE. 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":"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":"2026 八月十五 (Mid-Autumn Festival)","inputs":{"lunar_year":2026,"lunar_month":8,"is_leap_month":false,"lunar_day":15},"expected":{"gregorian_date":"2026-09-25","weekday":"Friday","month_days":29,"lunar_date_chinese":"二〇二六年八月十五","year_ganzhi":"丙午 (Bingwu)"},"url":"https://tttkmbb.com/api/v1/calculate/lunar-to-solar?lunar_year=2026&lunar_month=8&is_leap_month=false&lunar_day=15"},{"name":"2025 闰六月初一","inputs":{"lunar_year":2025,"lunar_month":6,"is_leap_month":true,"lunar_day":1},"expected":{"gregorian_date":"2025-07-25","weekday":"Friday","month_days":29,"month_name":"闰六月"},"url":"https://tttkmbb.com/api/v1/calculate/lunar-to-solar?lunar_year=2025&lunar_month=6&is_leap_month=true&lunar_day=1"}],"faq":[{"q":"What if I set is_leap_month for a year without that leap month?","a":"The conversion is rejected with INVALID_PARAMETER and the hint names the leap month that year actually has (for example 2033 has 闰十一月, starting 2033-12-22) or states that the year has none."},{"q":"Which year is 'lunar year 2025'?","a":"The year that begins at Chinese New Year 2025-01-29 and ends 2026-02-16; its 腊月 (12th month) therefore falls in January–February 2026 of the Gregorian calendar."}],"tags":["lunar to solar","chinese lunar date to gregorian","农历转公历","leap month","lunar birthday"],"related":[{"calculator_id":"lunar-calendar-converter","reason":"Gregorian to lunar conversion with solar terms and festivals."},{"calculator_id":"day-of-week","reason":"Weekday details for the resulting Gregorian date."},{"calculator_id":"chinese-festivals","reason":"Gregorian dates of all traditional festivals in a year."}],"links":{"html":"https://tttkmbb.com/lunar/lunar-to-solar","markdown":"https://tttkmbb.com/lunar/lunar-to-solar.md","json":"https://tttkmbb.com/lunar/lunar-to-solar.json","api":"https://tttkmbb.com/api/v1/calculate/lunar-to-solar","schema":"https://tttkmbb.com/api/v1/calculators/lunar-to-solar","openapi":"https://tttkmbb.com/openapi.json","mcp":"https://tttkmbb.com/mcp"},"version":"v1","updated_at":"2026-09-24"},"timestamp":"2026-09-24T08:34:09Z","next_actions":[{"tool":"run_calculator","calculator_id":"lunar-to-solar","reason":"Run Lunar to Solar Date Converter with the inputs above."}],"links":{"markdown":"https://tttkmbb.com/lunar/lunar-to-solar.md"}}