📅 Auspicious Date Calculator

📖 使用说明 (How to Use)

本工具基于中国传统黄历（通胜）的择日理论，帮助您为重要事项选择最佳日期。

This tool is based on the traditional Chinese almanac (Tong Sheng) date selection principles, helping you choose the best dates for important events.

• 选择事件类型：从10种常见事项中选择您要进行的活动（搬家、婚嫁、开业、出行、签约、动土、安床、投资、入学、求医）。
• Select event type: Choose from 10 common activities (moving, wedding, business opening, travel, contract signing, construction, bed installation, investment, study start, medical).
• 设置日期范围：选择起止日期，系统将扫描该时间段内的所有日子。
• Set date range: Select start and end dates. The system scans all days within that period.
• 查看结果：系统根据天干地支、十二建星、二十八宿等传统历法要素，为每天评分并标注吉凶。最佳日子会以绿色高亮显示。
• View results: The system scores each day based on Heavenly Stems, Earthly Branches, 12 Day Officers, and 28 Lunar Mansions. Best days are highlighted in green.
• 日历视图：日历以颜色编码显示每日吉凶——绿色为吉日、黄色为平日、红色为凶日。
• Calendar view: The calendar shows daily fortune with color coding — green for auspicious, yellow for neutral, red for inauspicious.

🏯 文化背景 (Cultural Background)

中国黄历（通胜）已有四千多年的历史，其核心是六十甲子（天干地支）循环系统——由十天干和十二地支组合而成的60个单位，形成一个不断重复的历法周期。择日（选择吉日）是中国文化中最深入日常生活的传统之一。

The Chinese almanac (Tong Sheng) has over 4,000 years of history. Its core is the Sexagenary Cycle — a 60-unit combination of 10 Heavenly Stems and 12 Earthly Branches forming a repeating calendar pattern. Choosing an auspicious date (Ze Ri) is one of the most deeply embedded traditions in Chinese daily life.

择日系统综合考虑多种历法要素：十二建星（建、除、满、平、定、执、破、危、成、收、开、闭）决定每日的基本吉凶；二十八宿（角亢氐房心尾箕等）提供更精细的宜忌指导；再加上当日天干地支的五行生克关系，形成完整的择日体系。中国人在婚嫁、搬家、开业、动土等重大事项前，通常会查阅黄历或请风水师择日。

The date selection system considers multiple calendrical elements: 12 Day Officers (Jian, Chu, Man, Ping, Ding, Zhi, Po, Wei, Cheng, Shou, Kai, Bi) determine the basic fortune of each day; 28 Lunar Mansions provide more detailed guidance; combined with the Five Element relationships of the day's Stem and Branch, forming a complete date selection system. Chinese families traditionally consult the almanac or a Feng Shui master before weddings, moves, business openings, and construction projects.