{"success":true,"version":"v1","request":{"tool":"get_calculator_schema","calculator_id":"chinese-almanac"},"result":{"entity_type":"calculator","id":"chinese-almanac","calculator_id":"chinese-almanac","canonical_url":"https://tttkmbb.com/lunar/chinese-almanac","name":"Chinese Almanac Day (黄历)","title":"Chinese Almanac Calculator (黄历 / 通胜) – Day Officer, Twelve Spirits, Clash, Sha Direction, Peng Zu Taboos and Hours","category":"lunar","category_name":"Chinese Calendar","tool_name":"describe_chinese_almanac_day","featured_mcp_tool":false,"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.","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":"weekday","label":"Weekday","type":"string","decimals":4,"description":"Day of the week of the Gregorian date."},{"name":"lunar_date_chinese","label":"Lunar date (农历)","type":"string","decimals":4,"description":"Chinese lunar calendar date in Chinese characters."},{"name":"lunar_date_english","label":"Lunar date (English)","type":"string","decimals":4,"description":"Lunar year, month and day in words."},{"name":"year_ganzhi","label":"Year (年柱)","type":"string","decimals":4,"description":"Stem-branch and zodiac of the lunar year; the 立春-based year is noted when it differs."},{"name":"month_ganzhi","label":"Month (月柱)","type":"string","decimals":4,"description":"Stem-branch of the solar month (changes at each 节)."},{"name":"day_ganzhi","label":"Day (日柱)","type":"string","decimals":4,"description":"Stem-branch of the day."},{"name":"day_ganzhi_pinyin","label":"Day (pinyin)","type":"string","decimals":4,"description":"Pinyin of the day stem-branch."},{"name":"day_officer","label":"Day officer (建除)","type":"string","decimals":4,"description":"One of the 建除十二神: index = (day branch − month branch) mod 12 over 建 除 满 平 定 执 破 危 成 收 开 闭."},{"name":"day_officer_pinyin","label":"Day officer (pinyin)","type":"string","decimals":4,"description":"Pinyin and English gloss of the officer."},{"name":"day_officer_meaning","label":"Officer meaning","type":"string","decimals":4,"description":"What the almanac tradition assigns to this officer."},{"name":"day_officer_type","label":"Officer type","type":"string","decimals":4,"description":"黄道 (除 危 定 执 成 开) or 黑道 (建 满 平 破 收 闭) by the 建除 tradition."},{"name":"twelve_spirits","label":"Day spirit (值神)","type":"string","decimals":4,"description":"Spirit of the day from the 十二神 sequence anchored by the month branch, with its 黄道/黑道 class."},{"name":"lunar_mansion","label":"Lunar mansion (二十八宿)","type":"string","decimals":4,"description":"The day's mansion in the 28-day cycle that follows the 7-day week (角 always on Thursday)."},{"name":"clash","label":"Clash (冲)","type":"string","decimals":4,"description":"Animal of the branch opposite the day branch."},{"name":"sha_direction","label":"Sha direction (煞)","type":"string","decimals":4,"description":"煞南 for 申子辰 days, 煞北 寅午戌, 煞东 巳酉丑, 煞西 亥卯未."},{"name":"year_break","label":"岁破 (year break)","type":"boolean","decimals":4,"description":"true when the day branch clashes the year branch (立春-based year)."},{"name":"month_break","label":"月破 (month break)","type":"boolean","decimals":4,"description":"true when the day branch clashes the month branch (the 破 officer day)."},{"name":"pengzu_taboos","label":"彭祖百忌","type":"string_list","decimals":4,"description":"The two Peng Zu taboo lines for the day stem and day branch, with an English gloss."},{"name":"auspicious_hours","label":"Hours (时辰吉凶)","type":"list","decimals":4,"description":"The twelve double-hours with their hourly spirit and 黄道/黑道 class (青龙 hour set by the day branch)."},{"name":"auspicious_hours_summary","label":"黄道吉时","type":"string","decimals":4,"description":"The six 黄道 hours of the day."},{"name":"solar_term_context","label":"Solar term","type":"string","decimals":4,"description":"Current and next solar term."},{"name":"disclaimer","label":"Disclaimer","type":"string","decimals":4,"description":"Cultural reference note."}],"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":{"weekday":{"description":"Day of the week of the Gregorian date.","type":"string"},"lunar_date_chinese":{"description":"Chinese lunar calendar date in Chinese characters.","type":"string"},"lunar_date_english":{"description":"Lunar year, month and day in words.","type":"string"},"year_ganzhi":{"description":"Stem-branch and zodiac of the lunar year; the 立春-based year is noted when it differs.","type":"string"},"month_ganzhi":{"description":"Stem-branch of the solar month (changes at each 节).","type":"string"},"day_ganzhi":{"description":"Stem-branch of the day.","type":"string"},"day_ganzhi_pinyin":{"description":"Pinyin of the day stem-branch.","type":"string"},"day_officer":{"description":"One of the 建除十二神: index = (day branch − month branch) mod 12 over 建 除 满 平 定 执 破 危 成 收 开 闭.","type":"string"},"day_officer_pinyin":{"description":"Pinyin and English gloss of the officer.","type":"string"},"day_officer_meaning":{"description":"What the almanac tradition assigns to this officer.","type":"string"},"day_officer_type":{"description":"黄道 (除 危 定 执 成 开) or 黑道 (建 满 平 破 收 闭) by the 建除 tradition.","type":"string"},"twelve_spirits":{"description":"Spirit of the day from the 十二神 sequence anchored by the month branch, with its 黄道/黑道 class.","type":"string"},"lunar_mansion":{"description":"The day's mansion in the 28-day cycle that follows the 7-day week (角 always on Thursday).","type":"string"},"clash":{"description":"Animal of the branch opposite the day branch.","type":"string"},"sha_direction":{"description":"煞南 for 申子辰 days, 煞北 寅午戌, 煞东 巳酉丑, 煞西 亥卯未.","type":"string"},"year_break":{"description":"true when the day branch clashes the year branch (立春-based year).","type":"boolean"},"month_break":{"description":"true when the day branch clashes the month branch (the 破 officer day).","type":"boolean"},"pengzu_taboos":{"description":"The two Peng Zu taboo lines for the day stem and day branch, with an English gloss.","type":"array","items":{"type":"string"}},"auspicious_hours":{"description":"The twelve double-hours with their hourly spirit and 黄道/黑道 class (青龙 hour set by the day branch).","type":"array"},"auspicious_hours_summary":{"description":"The six 黄道 hours of the day.","type":"string"},"solar_term_context":{"description":"Current and next solar term.","type":"string"},"disclaimer":{"description":"Cultural reference note.","type":"string"}}},"formula":"officer = (day_branch − month_branch) mod 12; day spirit = (day_branch − 青龙 branch of month) mod 12 with 青龙 on 子 for 寅申 months, 寅 for 卯酉, 辰 for 辰戌, 午 for 巳亥, 申 for 子午, 戌 for 丑未; hourly spirit = (hour_branch − 青龙 branch of day) mod 12 with the same table applied to the day branch; clash = (day_branch + 6) mod 12; mansion = (JDN − JDN(2026-07-01) + 6) mod 28","method":"Stem-branches, lunar date and solar terms from the calendar core (UTC+8 civil days); 建除 and 十二神 follow the 通胜 conventions listed in the formula; the 28-mansion cycle is anchored on 2026-07-01 = 箕 as confirmed by the ja.wikipedia branch/weekday table (貞享 2 = 1685-02-04 = 星) and published 2026 almanac pages. Traditional reference calculation of the Chinese calendar tradition; not a prediction and not medical, legal or financial advice.","sources":[{"name":"Tung Shing / 通勝 almanac (Wikipedia)","url":"https://en.wikipedia.org/wiki/Tung_Shing","type":"reference","retrieved_at":"2026-09-24"},{"name":"二十八宿 – weekday cycle and 貞享 anchor (Wikipedia, Japanese)","url":"https://ja.wikipedia.org/wiki/二十八宿","type":"reference","retrieved_at":"2026-09-24"},{"name":"Chinese calendar – rules of GB/T 33661-2017 (Wikipedia)","url":"https://en.wikipedia.org/wiki/Chinese_calendar","type":"reference","retrieved_at":"2026-09-24"}],"freshness":{"type":"daily","max_age_seconds":86400,"note":"Depends on the current date."},"examples":[{"name":"2026-09-24 (辛丑日, 丁酉月)","inputs":{"date":"2026-09-24"},"expected":{"weekday":"Thursday","lunar_date_chinese":"二〇二六年八月十四","month_ganzhi":"丁酉 (Dingyou)","day_ganzhi":"辛丑","day_ganzhi_pinyin":"Xinchou","day_officer":"定","day_officer_pinyin":"Ding (Settle)","day_officer_type":"黄道 (Huangdao) — favourable class by the 建除 tradition","twelve_spirits":"勾陈 (Gouchen, Hook Array) — 黑道 (Heidao, inauspicious)","lunar_mansion":"斗木獬 (Dou, Dipper; Wood 木 — Thursday)","clash":"冲羊 (Goat, 未): 辛丑日冲羊","sha_direction":"煞东 (East)","year_break":false,"month_break":false,"pengzu_taboos":["辛不合酱主人不尝 — Xin: do not make sauce, the host would not taste it","丑不冠带主不还乡 — Chou: do not hold a capping ceremony, the person would not return home"],"auspicious_hours_summary":"黄道吉时: 寅 卯 巳 申 戌 亥 (03:00–06:59, 09:00–10:59, 15:00–16:59, 19:00–22:59)"},"url":"https://tttkmbb.com/api/v1/calculate/chinese-almanac?date=2026-09-24"},{"name":"2024-02-10 Chinese New Year (甲辰日, 丙寅月)","inputs":{"date":"2024-02-10"},"expected":{"weekday":"Saturday","lunar_date_chinese":"二〇二四年正月初一","year_ganzhi":"甲辰 (Jiachen) — Dragon (龙)","month_ganzhi":"丙寅 (Bingyin)","day_ganzhi":"甲辰","day_officer":"满","day_officer_type":"黑道 (Heidao) — unfavourable class by the 建除 tradition","twelve_spirits":"金匮 (Jinkui, Golden Chest) — 黄道 (Huangdao, auspicious)","lunar_mansion":"氐土貉 (Di, Root; Earth 土 — Saturday)","clash":"冲狗 (Dog, 戌): 甲辰日冲狗","sha_direction":"煞南 (South)","year_break":false,"month_break":false,"pengzu_taboos":["甲不开仓财物耗散 — Jia: do not open the storehouse, goods would be wasted","辰不哭泣必主重丧 — Chen: do not weep, it would bring repeated mourning"]},"url":"https://tttkmbb.com/api/v1/calculate/chinese-almanac?date=2024-02-10"}],"faq":[{"q":"Why do 黄道 by officer and by spirit disagree?","a":"They are two separate traditions printed side by side in almanacs: 建除十二神 (twelve officers, cycle reset by the month branch) and 十二神 值神 (青龙 … 勾陈, position set by the month branch). A day can be 定 (黄道 officer) and 勾陈 (黑道 spirit) at the same time."},{"q":"Which year is used for 岁破?","a":"The 立春-based year of the 八字 tradition, so between 1 January and 立春 the previous year's branch applies; the lunar year shown with the lunar date can differ in that window."},{"q":"How is the 28-mansion day found?","a":"Modern almanacs run the 28 mansions as a fixed 28-day cycle synchronised with the week (角 木 on Thursday, 亢 金 Friday, 氐 土 Saturday, 房 日 Sunday, 心 月 Monday, 尾 火 Tuesday, 箕 水 Wednesday, then 斗 …), anchored here on 2026-07-01 = 箕."}],"tags":["黄历","chinese almanac","tung shing","day officer","建除","auspicious hours"],"related":[{"calculator_id":"lunar-calendar-converter","reason":"Full lunar date conversion for the same day."},{"calculator_id":"bazi-four-pillars","reason":"Birth chart built from the same stem-branch cycle."},{"calculator_id":"solar-terms","reason":"Dates of the 24 solar terms that set the month branch."}],"links":{"html":"https://tttkmbb.com/lunar/chinese-almanac","markdown":"https://tttkmbb.com/lunar/chinese-almanac.md","json":"https://tttkmbb.com/lunar/chinese-almanac.json","api":"https://tttkmbb.com/api/v1/calculate/chinese-almanac","schema":"https://tttkmbb.com/api/v1/calculators/chinese-almanac","openapi":"https://tttkmbb.com/openapi.json","mcp":"https://tttkmbb.com/mcp"},"version":"v1","updated_at":"2026-09-24"},"timestamp":"2026-09-24T08:33:19Z"}