{"success":true,"version":"v1","request":{"tool":"get_calculator_schema","calculator_id":"nine-star-feng-shui"},"result":{"entity_type":"calculator","id":"nine-star-feng-shui","calculator_id":"nine-star-feng-shui","canonical_url":"https://tttkmbb.com/lunar/nine-star-feng-shui","name":"Nine Star Periods (紫白飞星)","title":"Nine Star Calculator (九星 / 紫白) – Year, Month and Day Star and the 三元九运 Period of a Date","category":"lunar","category_name":"Chinese Calendar","tool_name":"calculate_nine_star_periods","featured_mcp_tool":false,"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.","inputs":[{"name":"date","label":"Date","type":"date","required":false,"default":"today","description":"Gregorian civil date in China Standard Time (1900–2100); defaults to the current UTC date.","example":"2026-09-24"}],"outputs":[{"name":"year_used","label":"Year used","type":"integer","decimals":0,"description":"Year of the 立春-based cycle that contains the date (the year changes at 立春, about 4 February)."},{"name":"year_star","label":"Year star (年紫白)","type":"integer","decimals":0,"description":"Annual star number 1–9."},{"name":"year_star_name","label":"Year star name","type":"string","decimals":4,"description":"Number, Chinese name, element and trigram of the annual star."},{"name":"month_star","label":"Month star (月紫白)","type":"integer","decimals":0,"description":"Monthly star number 1–9 for the solar month (changes at each 节)."},{"name":"month_star_name","label":"Month star name","type":"string","decimals":4,"description":"Number, name, element and trigram of the monthly star."},{"name":"day_star","label":"Day star (日紫白)","type":"integer","decimals":0,"description":"Daily star number 1–9 (simplified 阳遁/阴遁 convention, see method)."},{"name":"day_star_name","label":"Day star name","type":"string","decimals":4,"description":"Number, name, element and trigram of the daily star."},{"name":"day_star_cycle","label":"Day star cycle","type":"string","decimals":4,"description":"Whether the day is in the ascending 阳遁 or descending 阴遁 sequence and the 甲子 day it starts from."},{"name":"period_number","label":"Period (运)","type":"integer","decimals":0,"description":"Period 1–9 of the 三元九运 cycle."},{"name":"period_name","label":"Period name","type":"string","decimals":4,"description":"Yuan and period, e.g. 下元九运."},{"name":"period_years","label":"Period years","type":"string","decimals":4,"description":"First and last calendar year of the period (each begins at 立春)."},{"name":"period_trigram_element","label":"Period trigram and element","type":"string","decimals":4,"description":"Trigram and element of the period's star."},{"name":"notes","label":"Notes","type":"string_list","decimals":4,"description":"Conventions applied."}],"input_schema":{"type":"object","properties":{"date":{"description":"Gregorian civil date in China Standard Time (1900–2100); defaults to the current UTC date.","type":"string","format":"date","default":"today","examples":["2026-09-24"]}},"additionalProperties":false},"output_schema":{"type":"object","properties":{"year_used":{"description":"Year of the 立春-based cycle that contains the date (the year changes at 立春, about 4 February).","type":"integer"},"year_star":{"description":"Annual star number 1–9.","type":"integer"},"year_star_name":{"description":"Number, Chinese name, element and trigram of the annual star.","type":"string"},"month_star":{"description":"Monthly star number 1–9 for the solar month (changes at each 节).","type":"integer"},"month_star_name":{"description":"Number, name, element and trigram of the monthly star.","type":"string"},"day_star":{"description":"Daily star number 1–9 (simplified 阳遁/阴遁 convention, see method).","type":"integer"},"day_star_name":{"description":"Number, name, element and trigram of the daily star.","type":"string"},"day_star_cycle":{"description":"Whether the day is in the ascending 阳遁 or descending 阴遁 sequence and the 甲子 day it starts from.","type":"string"},"period_number":{"description":"Period 1–9 of the 三元九运 cycle.","type":"integer"},"period_name":{"description":"Yuan and period, e.g. 下元九运.","type":"string"},"period_years":{"description":"First and last calendar year of the period (each begins at 立春).","type":"string"},"period_trigram_element":{"description":"Trigram and element of the period's star.","type":"string"},"notes":{"description":"Conventions applied.","type":"array","items":{"type":"string"}}}},"formula":"year_star = 1 − ((year − 1864) mod 9) wrapped into 1–9; month_star = start − months since 寅, start = 8 for 子午卯酉 years, 5 for 辰戌丑未, 2 for 寅申巳亥; day_star = 1 + n (阳遁) or 9 − n (阴遁) wrapped into 1–9, n = days since the first 甲子 day on or after the winter (阳) or summer (阴) solstice; period = floor((year − 1864) / 20) + 1","method":"Year and period use the 立春 boundary. The day star uses the simplified convention that 阳遁 starts at 一白 on the first 甲子 day on or after the winter solstice and 阴遁 starts at 九紫 on the first 甲子 day on or after the summer solstice; almanacs that shift the start to the 甲子 nearest the solstice (with 置闰 adjustments) can differ. Traditional reference calculation of the Chinese calendar tradition; not a prediction and not medical, legal or financial advice.","sources":[{"name":"Flying Star Feng Shui – nine stars and 20-year periods (Wikipedia)","url":"https://en.wikipedia.org/wiki/Flying_Star_Feng_Shui","type":"reference","retrieved_at":"2026-09-24"},{"name":"Lo Shu Square (Wikipedia)","url":"https://en.wikipedia.org/wiki/Lo_Shu_Square","type":"reference","retrieved_at":"2026-09-24"},{"name":"Solar term (Wikipedia)","url":"https://en.wikipedia.org/wiki/Solar_term","type":"reference","retrieved_at":"2026-09-24"}],"freshness":{"type":"daily","max_age_seconds":86400,"note":"Depends on the current date."},"examples":[{"name":"2024-06-01 (first year of Period 9)","inputs":{"date":"2024-06-01"},"expected":{"year_used":2024,"year_star":3,"year_star_name":"3 三碧 (Sanbi) — Wood, 震 Zhen","month_star":2,"day_star":9,"day_star_cycle":"阳遁 (yang, ascending) from the 甲子 day 2024-01-01 (day 153 of the sequence)","period_number":9,"period_name":"下元九运 (Xiayuan, lower yuan, period 9)","period_years":"2024–2043","period_trigram_element":"离 Li — Fire (九紫 Jiuzi)"},"url":"https://tttkmbb.com/api/v1/calculate/nine-star-feng-shui?date=2024-06-01"},{"name":"2026-09-24","inputs":{"date":"2026-09-24"},"expected":{"year_used":2026,"year_star":1,"year_star_name":"1 一白 (Yibai) — Water, 坎 Kan","month_star":1,"day_star":8,"period_number":9,"period_years":"2024–2043"},"url":"https://tttkmbb.com/api/v1/calculate/nine-star-feng-shui?date=2026-09-24"}],"faq":[{"q":"Why does the year star change at 立春 and not at Chinese New Year?","a":"Flying-star tables follow the solar (节气) calendar like Bazi: 2026 becomes a 一白 year on 2026-02-04, thirteen days before Chinese New Year."},{"q":"When did Period 9 start?","a":"Period 9 (下元九运, 九紫离火) runs from 立春 2024 (2024-02-04) to 立春 2044; Period 1 of the next 180-year cycle starts in 2044."},{"q":"Why might the day star differ from my almanac?","a":"Daily stars have several published conventions for choosing the 甲子 day that starts each 阳遁/阴遁 half-year. This calculator states its rule in the day_star_cycle output so results can be compared."}],"tags":["nine star","紫白飞星","flying star","period 9","三元九运","feng shui"],"related":[{"calculator_id":"chinese-almanac","reason":"Other day attributes of the same date."},{"calculator_id":"solar-terms","reason":"立春 and the 节 that start each month star."},{"calculator_id":"chinese-zodiac","reason":"Zodiac and stem-branch of the year."}],"links":{"html":"https://tttkmbb.com/lunar/nine-star-feng-shui","markdown":"https://tttkmbb.com/lunar/nine-star-feng-shui.md","json":"https://tttkmbb.com/lunar/nine-star-feng-shui.json","api":"https://tttkmbb.com/api/v1/calculate/nine-star-feng-shui","schema":"https://tttkmbb.com/api/v1/calculators/nine-star-feng-shui","openapi":"https://tttkmbb.com/openapi.json","mcp":"https://tttkmbb.com/mcp"},"version":"v1","updated_at":"2026-09-24"},"timestamp":"2026-09-24T08:35:03Z"}