{"success":true,"version":"v1","request":{"tool":"list_calculators","category":"lunar"},"result":{"entity_type":"calculator_list","status":"completed","count":13,"calculators":[{"calculator_id":"lunar-calendar-converter","entity_type":"calculator","name":"Lunar Calendar Converter (农历)","category":"lunar","tool_name":"convert_solar_to_lunar","description":"Converts a Gregorian date to the Chinese lunisolar calendar (农历 nongli): lunar year, month (with leap-month flag), day, the sexagenary stems and branches (干支 ganzhi) of year, month and day, zodiac animal, nayin (纳音), the current 24-solar-term period and any traditional festival on that day.","use_when":"You need the Chinese lunar date, ganzhi day/month/year, zodiac year or current solar term for a given Gregorian date (defaults to today).","do_not_use_when":"You start from a lunar date and need the Gregorian date (use lunar-to-solar), need a person's zodiac with the 立春 boundary option (use chinese-zodiac), or need the astronomical moon phase (use moon-phase).","required_inputs":[],"optional_inputs":["date"],"urls":{"html":"https://tttkmbb.com/lunar/lunar-calendar-converter","markdown":"https://tttkmbb.com/lunar/lunar-calendar-converter.md","schema":"https://tttkmbb.com/api/v1/calculators/lunar-calendar-converter","api":"https://tttkmbb.com/api/v1/calculate/lunar-calendar-converter"}},{"calculator_id":"lunar-to-solar","entity_type":"calculator","name":"Lunar to Solar Date Converter","category":"lunar","tool_name":"convert_lunar_to_solar","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).","required_inputs":["lunar_year","lunar_month","lunar_day"],"optional_inputs":["is_leap_month"],"urls":{"html":"https://tttkmbb.com/lunar/lunar-to-solar","markdown":"https://tttkmbb.com/lunar/lunar-to-solar.md","schema":"https://tttkmbb.com/api/v1/calculators/lunar-to-solar","api":"https://tttkmbb.com/api/v1/calculate/lunar-to-solar"}},{"calculator_id":"solar-terms","entity_type":"calculator","name":"24 Solar Terms Calculator (二十四节气)","category":"lunar","tool_name":"list_solar_terms","description":"Lists the 24 solar terms (节气 jieqi) of a Gregorian year with their exact instants: the moments the Sun's apparent longitude reaches multiples of 15°, computed astronomically and shown in a chosen UTC offset (China Standard Time by default).","use_when":"You need the date or time of 立春, 清明, 夏至, 冬至 or any other solar term in a given year, or the full 24-term table.","do_not_use_when":"You only need the term that a specific date falls in (use lunar-calendar-converter), or you need sunrise/sunset times (use sunrise-sunset).","required_inputs":["year"],"optional_inputs":["utc_offset_hours"],"urls":{"html":"https://tttkmbb.com/lunar/solar-terms","markdown":"https://tttkmbb.com/lunar/solar-terms.md","schema":"https://tttkmbb.com/api/v1/calculators/solar-terms","api":"https://tttkmbb.com/api/v1/calculate/solar-terms"}},{"calculator_id":"chinese-zodiac","entity_type":"calculator","name":"Chinese Zodiac Calculator (生肖)","category":"lunar","tool_name":"find_chinese_zodiac","description":"Finds the Chinese zodiac animal (生肖 shengxiao), sexagenary year (干支 ganzhi), stem element, yin/yang, nayin (纳音) and fixed element for a birth date, using either the Chinese New Year boundary or the 立春 (Lichun) boundary, plus the traditional relationship groups (六合, 三合, 六冲, 六害, 相刑) and 本命年 years.","use_when":"You need someone's Chinese zodiac sign and element from a Gregorian birth date, especially for January–February births where the boundary matters, or the sign's traditional compatibility groups.","do_not_use_when":"You need a full Bazi chart with month, day and hour pillars (use bazi-four-pillars), or the Western star sign (use zodiac).","required_inputs":["birth_date"],"optional_inputs":["boundary","reference_year"],"urls":{"html":"https://tttkmbb.com/lunar/chinese-zodiac","markdown":"https://tttkmbb.com/lunar/chinese-zodiac.md","schema":"https://tttkmbb.com/api/v1/calculators/chinese-zodiac","api":"https://tttkmbb.com/api/v1/calculate/chinese-zodiac"}},{"calculator_id":"sexagenary-cycle","entity_type":"calculator","name":"Sexagenary Cycle Calculator (干支)","category":"lunar","tool_name":"convert_sexagenary_year","description":"Converts a year to its sexagenary name (干支 ganzhi: heavenly stem 天干 + earthly branch 地支) or a ganzhi name back to the matching years, with the stem element, yin/yang, zodiac animal, nayin (纳音), position in the 60-year cycle and the full 60-entry table.","use_when":"You need the ganzhi of a year (e.g. 2026 = 丙午), the years that carry a given name such as 甲子 or 辛亥, or the whole 60-year cycle with its nayin elements.","do_not_use_when":"You need the ganzhi of a day, month or hour for a date (use lunar-calendar-converter or chinese-hour), or the zodiac for a birth date near Chinese New Year (use chinese-zodiac).","required_inputs":[],"optional_inputs":["year","ganzhi","range_start","range_end"],"urls":{"html":"https://tttkmbb.com/lunar/sexagenary-cycle","markdown":"https://tttkmbb.com/lunar/sexagenary-cycle.md","schema":"https://tttkmbb.com/api/v1/calculators/sexagenary-cycle","api":"https://tttkmbb.com/api/v1/calculate/sexagenary-cycle"}},{"calculator_id":"chinese-hour","entity_type":"calculator","name":"Chinese Double-Hour Calculator (时辰)","category":"lunar","tool_name":"convert_to_chinese_hour","description":"Converts a clock time to the traditional Chinese double-hour (时辰 shichen): its earthly branch (子 … 亥), animal and index, and, when a date is given, the hour's ganzhi (干支) by the 五鼠遁 (five-rats) rule from the day stem, with the option to count the late 子 hour (23:00–23:59) with the next day.","use_when":"You need the 时辰 of a birth time or event (e.g. for a Bazi hour pillar), or the table of the twelve double-hours.","do_not_use_when":"You need the full four pillars (use bazi-four-pillars), or you need to convert the clock time between time zones first (use time-zone-converter).","required_inputs":["time"],"optional_inputs":["date","late_zi_next_day"],"urls":{"html":"https://tttkmbb.com/lunar/chinese-hour","markdown":"https://tttkmbb.com/lunar/chinese-hour.md","schema":"https://tttkmbb.com/api/v1/calculators/chinese-hour","api":"https://tttkmbb.com/api/v1/calculate/chinese-hour"}},{"calculator_id":"lunar-age","entity_type":"calculator","name":"Chinese Nominal Age Calculator (虚岁)","category":"lunar","tool_name":"calculate_chinese_nominal_age","description":"Computes the traditional Chinese nominal age (虚岁 xusui: one at birth, plus one at every Chinese New Year) alongside the completed-years age (周岁 zhousui), and finds the lunar birthday (农历生日), its Gregorian date in the current lunar year, the days to the next lunar birthday and the next 本命年.","use_when":"You need someone's 虚岁 for a Chinese context (family, temple, almanac conventions), or the date of a lunar birthday in a given year.","do_not_use_when":"You need the ordinary age in years, months and days (use age), or the zodiac sign details (use chinese-zodiac).","required_inputs":["birth_date"],"optional_inputs":["reference_date"],"urls":{"html":"https://tttkmbb.com/lunar/lunar-age","markdown":"https://tttkmbb.com/lunar/lunar-age.md","schema":"https://tttkmbb.com/api/v1/calculators/lunar-age","api":"https://tttkmbb.com/api/v1/calculate/lunar-age"}},{"calculator_id":"chinese-festivals","entity_type":"calculator","name":"Chinese Festival Dates Calculator","category":"lunar","tool_name":"list_chinese_festivals","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).","required_inputs":["year"],"optional_inputs":[],"urls":{"html":"https://tttkmbb.com/lunar/chinese-festivals","markdown":"https://tttkmbb.com/lunar/chinese-festivals.md","schema":"https://tttkmbb.com/api/v1/calculators/chinese-festivals","api":"https://tttkmbb.com/api/v1/calculate/chinese-festivals"}},{"calculator_id":"bazi-four-pillars","entity_type":"calculator","name":"Bazi Four Pillars (八字)","category":"lunar","tool_name":"calculate_bazi_four_pillars","description":"Builds the Bazi (八字, Bāzì) / Four Pillars (四柱) chart of a birth date and time: year pillar by 立春 (Lìchūn), month pillar by the 节 (jié) solar terms, day pillar from the sexagenary day count, hour pillar by the 五鼠遁 (Wǔshǔdùn) rule, plus day master, five-element counts, ten gods (十神), hidden stems (藏干), 纳音 (nàyīn), void branches (空亡) and the ten-year luck pillars (大运).","use_when":"You need the four stem-branch pillars (年柱 月柱 日柱 时柱) of a birth moment, the day master and its ten-god relations, element balance, or the start age and sequence of the 大运 luck pillars.","do_not_use_when":"You only need the lunar date or zodiac of a date (use lunar-calendar-converter or chinese-zodiac), the stem-branch of a single date without an hour (use sexagenary-cycle), or an interpretation of the chart — this tool computes the traditional chart only and gives no predictions.","required_inputs":["birth_date","birth_time","sex"],"optional_inputs":["utc_offset_hours","longitude_degrees","late_zi_next_day","include_hidden_stems"],"urls":{"html":"https://tttkmbb.com/lunar/bazi-four-pillars","markdown":"https://tttkmbb.com/lunar/bazi-four-pillars.md","schema":"https://tttkmbb.com/api/v1/calculators/bazi-four-pillars","api":"https://tttkmbb.com/api/v1/calculate/bazi-four-pillars"}},{"calculator_id":"chinese-almanac","entity_type":"calculator","name":"Chinese Almanac Day (黄历)","category":"lunar","tool_name":"describe_chinese_almanac_day","description":"Computes the traditional almanac (黄历 huánglì / 通胜 tōngshèng) entries of a civil date: lunar date, stem-branches, the 建除十二神 day officer, the 黄道/黑道 twelve spirits of the day and of each double-hour, the clashing animal, 煞 direction, 岁破/月破 flags, the 彭祖百忌 taboo lines and the 28-mansion (二十八宿) of the day.","use_when":"You need the almanac attributes of a date as printed in a Chinese calendar (宜忌 background): day officer, 值神, 冲煞, 彭祖百忌, auspicious hours or the day's 宿.","do_not_use_when":"You need the lunar date or solar term only (use lunar-calendar-converter or solar-terms), a birth chart (use bazi-four-pillars), or a decision — the entries are traditional attributions, not advice.","required_inputs":[],"optional_inputs":["date"],"urls":{"html":"https://tttkmbb.com/lunar/chinese-almanac","markdown":"https://tttkmbb.com/lunar/chinese-almanac.md","schema":"https://tttkmbb.com/api/v1/calculators/chinese-almanac","api":"https://tttkmbb.com/api/v1/calculate/chinese-almanac"}},{"calculator_id":"nine-star-feng-shui","entity_type":"calculator","name":"Nine Star Periods (紫白飞星)","category":"lunar","tool_name":"calculate_nine_star_periods","description":"Finds the annual, monthly and daily 紫白 (zǐbái) star (一白 … 九紫) of a date and its 20-year period in the 180-year 三元九运 (sānyuán jiǔyùn) cycle counted from 1864, as used in Flying Star (玄空飞星) feng shui reference tables.","use_when":"You need the 年紫白 / 月紫白 / 日紫白 star numbers of a date, the current 运 (period) and its years, or the trigram and element assigned to each star.","do_not_use_when":"You need a building's flying-star chart (sitting/facing directions are required), the Ming Gua of a person (use ming-gua in the yijing category), or advice — this is a table lookup, not an evaluation.","required_inputs":[],"optional_inputs":["date"],"urls":{"html":"https://tttkmbb.com/lunar/nine-star-feng-shui","markdown":"https://tttkmbb.com/lunar/nine-star-feng-shui.md","schema":"https://tttkmbb.com/api/v1/calculators/nine-star-feng-shui","api":"https://tttkmbb.com/api/v1/calculate/nine-star-feng-shui"}},{"calculator_id":"era-year-converter","entity_type":"calculator","name":"Era Year Converter","category":"lunar","tool_name":"convert_year_to_eras","description":"Converts a Gregorian year (optionally an exact date) into the year counts of other calendars and eras: 民国 (Mínguó), Japanese 元号 (gengō), Thai Buddhist Era, 黄帝纪元 (Huángdì), 檀纪 (Dangun), 主体 (Juche), 皇纪 (kōki), Holocene, tabular Islamic (AH), Hebrew (AM), Solar Hijri, Ethiopian, Coptic and Byzantine years, plus the Chinese stem-branch year and zodiac.","use_when":"You need to label a year in another era system, know which two years of a calendar overlap a Gregorian year, or find the era in effect on a specific date (e.g. 昭和 or 平成 in 1989).","do_not_use_when":"You need a full date conversion into the Chinese lunar calendar (use lunar-calendar-converter) or a religious calendar date fixed by observation (Islamic dates here are tabular and can differ by 1–2 days).","required_inputs":["year"],"optional_inputs":["date"],"urls":{"html":"https://tttkmbb.com/lunar/era-year-converter","markdown":"https://tttkmbb.com/lunar/era-year-converter.md","schema":"https://tttkmbb.com/api/v1/calculators/era-year-converter","api":"https://tttkmbb.com/api/v1/calculate/era-year-converter"}},{"calculator_id":"zodiac-compatibility","entity_type":"calculator","name":"Chinese Zodiac Compatibility (生肖配对)","category":"lunar","tool_name":"check_chinese_zodiac_compatibility","description":"Lists the traditional earthly-branch relations between two Chinese zodiac animals: 六合 (liùhé, six harmonies / secret friends), 三合 (sānhé, trines), 六冲 (liùchōng, clashes), 六害 (liùhài, harms), 相刑 (xiāngxíng, punishments), 相破 (xiāngpò, breaks) and 比和 (same sign), with each animal's trine group, fixed element and polarity.","use_when":"You need the classical relation between two zodiac signs (e.g. Rat and Ox are 六合, Rat and Horse are 六冲) or the trine group and fixed element of a sign.","do_not_use_when":"You need someone's zodiac sign from a birth date (use chinese-zodiac first) or a full birth-chart comparison (use bazi-four-pillars); the relations are traditional attributions, not relationship advice.","required_inputs":["zodiac_a","zodiac_b"],"optional_inputs":[],"urls":{"html":"https://tttkmbb.com/lunar/zodiac-compatibility","markdown":"https://tttkmbb.com/lunar/zodiac-compatibility.md","schema":"https://tttkmbb.com/api/v1/calculators/zodiac-compatibility","api":"https://tttkmbb.com/api/v1/calculate/zodiac-compatibility"}}]},"timestamp":"2026-09-24T08:34:08Z","next_actions":[],"links":{"docs":"https://tttkmbb.com/calculators.md"}}