Chinese lunar almanac (huangli) — daily 宜/忌 advice, 24 solar terms, 干支/生肖, auspicious hours, any date 1900-2100.
- Runs locally
- Category Calculator
- Best for Getting a realistic range before a purchase, plan, workout, or schedule decision.
- 祭祀
- 解除
- 沐浴
- 扫舍
- 疗病
- 除服
- 剃头
- 修造
- 嫁娶
- 入宅
- 开市
- 远行
- 搬迁
What this tool does
Free Chinese lunar almanac (黄历 / 万年历) for any Gregorian date between 1900 and 2100. Type a date — or just open the page for today — and you get a full traditional Chinese 通书 page: lunar (农历) date with leap-month support, year/month/day/hour 干支 pillars, Chinese zodiac (生肖), the nearest 24 solar term and whether today IS one, the 建除十二神 day-quality, the 二十八宿 lodge, today's 宜 (auspicious) and 忌 (inauspicious) activity lists (5-8 each), the 冲煞 — which zodiac is "clashed" and which direction is afflicted — and a 12-时辰 (double-hour) auspicious / inauspicious chart so you can pick a 吉时 within the day. Plus the 彭祖百忌 verse for the day's 甲子, and five one-click queries for the activities Chinese culture cares about most: 嫁娶 (wedding), 搬家 (moving), 开业 (opening a business), 出行 (travel), 安葬 (burial). All calculation is in your browser using inline 1900-2100 lunar tables (~7 KB) and the standard 建除 / 28-宿 / 六十甲子 lookup — no API, no network. This is a cultural reference, NOT a decision-making oracle: huangli is Chinese folk tradition, not science, and the page says so up top before showing any 宜/忌.
Tool details
- Input
- Form fields
- The page exposes text boxes, numeric controls, file pickers, or structured inputs depending on the tool.
- Output
- Live result + Preview
- The result area focuses on usable output, with copy, download, or preview actions when supported.
- Privacy
- Browser-side processing
- The main tool logic does not call an external API, so inputs normally stay in the current tab.
- Save / share
- Shareable URL state
- Key settings are encoded in the URL so another person can reopen the same setup.
- Performance budget
- Initial JS <= 60 KB
- No WASM budget is declared, keeping the tool quick to open on mobile.
- Best fit
- Calculator · Marketer
- Category and role tags drive related tools, internal links, and quick fit checks.
How to use
-
1. Input
Paste or drop your content into the tool panel.
-
2. Process
Click the button. All processing is local in your browser.
-
3. Copy / Download
Copy the result or download to disk in one click.
How Chinese Lunar Almanac (Huangli) fits into your work
Use it for fast estimates, comparisons, and planning numbers before you make the final call.
Calculation jobs
- Getting a realistic range before a purchase, plan, workout, or schedule decision.
- Comparing scenarios by changing one input at a time.
- Turning rough assumptions into a number you can discuss.
Calculation checks
- Double-check units, dates, rates, and rounding assumptions.
- Treat health, finance, tax, and legal outputs as planning aids, not professional advice.
- Save the inputs that produced an important result so you can reproduce it later.
Good next steps
These links move the current task into a more complete workflow.
- 1 Age Calculator Calculate your exact age — years, months, days, hours. Compare two dates or count to a future date. Open
- 2 Chinese Zodiac Sign Checker (Sheng Xiao) Chinese zodiac checker — your animal sign, element, compatibility, lucky numbers/colors by birth year. Open
- 3 China Retirement Age Calculator China retirement age calculator (2025 reform) — exact retirement date by birth year + gender + worker category, per Sept 2024 NPC reform. Open
Real-world use cases
Pick a wedding date your future in-laws will approve
You and your partner have narrowed down to three candidate Saturdays next year. Type each one into the date box and look at the 嫁娶 row in the five-activity quick-check. Two come back "宜嫁娶" (consensus-auspicious for weddings) and one comes back "忌嫁娶". You forward the auspicious two to both sets of parents, let them pick, and the family conversation skips the "but it's not a good day" objection entirely — because the printed 通书 they'd consult says exactly the same thing this tool does.
Choose a moving day that doesn't clash with the household zodiac
Your family includes someone born in the year of the Rat, someone born in the year of the Horse. You're picking a weekend in October to move to a new apartment. The almanac shows you "今日冲鼠" on one of the candidate Saturdays — meaning that day clashes with anyone born in a Rat year. Skip that day, pick the next one where 搬家 is 宜 and no family member is in the 冲 column. Five seconds, no awkward family debate.
Schedule a business opening and the ribbon-cutting hour
You're opening a small bakery on a chosen day next month. The almanac shows 宜开业 for the day, then look at the 12-时辰 chart: 辰时 (07-09), 巳时 (09-11), 午时 (11-13) are all marked 吉, 未时 (13-15) is 凶. Schedule the ribbon-cutting for 09:30, the soft-open for 10:30 — right inside the auspicious window. Your aunt who reads the printed 通书 will see the time and nod.
Plan a long-distance trip the traditional way
Booking a flight home for Chinese New Year week. The almanac flags 忌远行 on the day you were thinking of. Move the flight to one day earlier where 出行 is 宜. You're not superstitious, but Grandma is, and "I checked the 黄历" is a much shorter conversation than "actually flights are cheaper that day".
Settle a family debate about a funeral / burial date
A relative has passed and the family needs to pick a burial date 7 days out. The almanac's 安葬 quick-check immediately rules out the two days where 忌安葬 appears and surfaces the two where 宜安葬 holds. The decision stops being "whoever speaks loudest in the WeChat group" and becomes "let the tradition pick". The elderly relatives feel heard; the working-age relatives don't have to drive to the funeral home twice to compare days.
Common pitfalls
Treating 宜/忌 as a hard rule instead of a soft cultural reference. The almanac is a 1000-year folk tradition, not a verified predictor; if a date that's perfect for your family says 忌, that's worth a moment's thought, not a veto.
Confusing 冲 (the day's clashing zodiac) with the person's own zodiac. 今日冲鼠 means anyone born in a Rat year should be cautious about big activities that day — your own zodiac always "clashes" with the day exactly twice a month, so don't panic on those days.
Looking at 宜/忌 without checking the 时辰 chart. A day can be 宜开业 overall but have only 2-3 吉 hours in the morning; if you scheduled the ribbon-cutting at 13:00 (a 凶 hour that day), the day-level 宜 doesn't override the hour-level 凶 in traditional reading.
Forgetting that 节气 dates shift in time. The 24 solar terms move by up to 1 day across the century — this tool computes the term date dynamically per year, so the result on "立春 day" varies from Feb 3 to Feb 5 depending on the Gregorian year.
Privacy
The 1900-2100 lunar ephemeris (~7 KB), the 建除 / 28-宿 / 60- 甲子 / 彭祖百忌 lookup tables (~15 KB), and all date math run inside your browser as plain JavaScript. The date you enter, the 宜/忌 result, the 时辰 chart, the 冲煞 line — none of it is sent to any server, logged, or used to train any model. You can use this on a phone with no signal once the page is cached, and the answer for any 1900-2100 date will be identical to the printed 通书.
FAQ
Tool combos
Folks in your role tend to reach for these alongside this tool.
- AI Model Comparison AI model comparison — 20+ models (GPT / Claude / Gemini / Llama / Qwen) across price, context, speed, capabilities (2026).
- Annuity Calculator Annuity & retirement calculator — see monthly income from your savings, accumulation + payout phases, multiple scenarios.
- Avatar Generator Generate avatars from initials, identicons, or random shapes. Download PNG/SVG.
- Barcode Generator Code 128 / EAN-13 / UPC-A / Code 39 — generate scannable 1D barcodes, export SVG or PNG, fully offline.