月历Calendar
月历,用来选一个日期。日期下面可以带一行农历,或者一枚月相。
演示
十一月
一二三四五六日
今天 丙午年十月初十
十一月
一二三四五六日
今天 丙午年十月初十7 日立冬22 日小雪
November
MTWTFSS
Today: lunar month 10, day 10Nov 7, Start of WinterNov 22, Minor Snow
<div class="hao-row" style="gap:var(--hao-space-6);align-items:flex-start">
<div class="hao-cal" data-hao-calendar data-mode="lunar" data-today="2026-11-18" data-value="2026-11-20">
<div class="hao-cal__head">
<h2 class="hao-cal__title">十一月</h2>
<span>
<button class="hao-cal__nav" aria-label="上个月"><i class="hao-icon hao-icon--chevron-left" aria-hidden="true"></i></button>
<button class="hao-cal__nav" aria-label="下个月"><i class="hao-icon hao-icon--chevron-right" aria-hidden="true"></i></button>
</span>
</div>
<div class="hao-cal__grid">
<span class="hao-cal__dow">一</span>
<span class="hao-cal__dow">二</span>
<span class="hao-cal__dow">三</span>
<span class="hao-cal__dow">四</span>
<span class="hao-cal__dow">五</span>
<span class="hao-cal__dow">六</span>
<span class="hao-cal__dow">日</span>
<button class="hao-cal__day hao-cal__day--out" tabindex="-1">26<small class="hao-cal__lunar">十七</small></button>
<button class="hao-cal__day hao-cal__day--out" tabindex="-1">27<small class="hao-cal__lunar">十八</small></button>
<button class="hao-cal__day hao-cal__day--out" tabindex="-1">28<small class="hao-cal__lunar">十九</small></button>
<button class="hao-cal__day hao-cal__day--out" tabindex="-1">29<small class="hao-cal__lunar">二十</small></button>
<button class="hao-cal__day hao-cal__day--out" tabindex="-1">30<small class="hao-cal__lunar">廿一</small></button>
<button class="hao-cal__day hao-cal__day--out" tabindex="-1">31<small class="hao-cal__lunar">廿二</small></button>
<button class="hao-cal__day">1<small class="hao-cal__lunar">廿三</small></button>
<button class="hao-cal__day">2<small class="hao-cal__lunar">廿四</small></button>
<button class="hao-cal__day">3<small class="hao-cal__lunar">廿五</small></button>
<button class="hao-cal__day">4<small class="hao-cal__lunar">廿六</small></button>
<button class="hao-cal__day">5<small class="hao-cal__lunar">廿七</small></button>
<button class="hao-cal__day">6<small class="hao-cal__lunar">廿八</small></button>
<button class="hao-cal__day">7<small>立冬</small></button>
<button class="hao-cal__day">8<small class="hao-cal__lunar">三十</small></button>
<button class="hao-cal__day">9<small class="hao-cal__lunar hao-cal__lunar--first">十月</small></button>
<button class="hao-cal__day">10<small class="hao-cal__lunar">初二</small></button>
<button class="hao-cal__day">11<small class="hao-cal__lunar">初三</small></button>
<button class="hao-cal__day">12<small class="hao-cal__lunar">初四</small></button>
<button class="hao-cal__day">13<small class="hao-cal__lunar">初五</small></button>
<button class="hao-cal__day">14<small class="hao-cal__lunar">初六</small></button>
<button class="hao-cal__day">15<small class="hao-cal__lunar">初七</small></button>
<button class="hao-cal__day">16<small class="hao-cal__lunar">初八</small></button>
<button class="hao-cal__day">17<small class="hao-cal__lunar">初九</small></button>
<button class="hao-cal__day" aria-current="date">18<small class="hao-cal__lunar">初十</small></button>
<button class="hao-cal__day">19<small class="hao-cal__lunar">十一</small></button>
<button class="hao-cal__day" aria-pressed="true">20<small class="hao-cal__lunar">十二</small></button>
<button class="hao-cal__day">21<small class="hao-cal__lunar">十三</small></button>
<button class="hao-cal__day">22<small>小雪</small></button>
<button class="hao-cal__day">23<small class="hao-cal__lunar">十五</small></button>
<button class="hao-cal__day">24<small class="hao-cal__lunar">十六</small></button>
<button class="hao-cal__day">25<small class="hao-cal__lunar">十七</small></button>
<button class="hao-cal__day">26<small class="hao-cal__lunar">十八</small></button>
<button class="hao-cal__day">27<small class="hao-cal__lunar">十九</small></button>
<button class="hao-cal__day">28<small class="hao-cal__lunar">二十</small></button>
<button class="hao-cal__day">29<small class="hao-cal__lunar">廿一</small></button>
<button class="hao-cal__day">30<small class="hao-cal__lunar">廿二</small></button>
</div>
<p class="hao-cal__foot"><span>今天 丙午年十月初十</span></p>
</div>
<div class="hao-cal" data-hao-calendar data-mode="moon" data-today="2026-11-18" data-value="2026-11-20">
<div class="hao-cal__head">
<h2 class="hao-cal__title">十一月</h2>
<span>
<button class="hao-cal__nav" aria-label="上个月"><i class="hao-icon hao-icon--chevron-left" aria-hidden="true"></i></button>
<button class="hao-cal__nav" aria-label="下个月"><i class="hao-icon hao-icon--chevron-right" aria-hidden="true"></i></button>
</span>
</div>
<div class="hao-cal__grid">
<span class="hao-cal__dow">一</span>
<span class="hao-cal__dow">二</span>
<span class="hao-cal__dow">三</span>
<span class="hao-cal__dow">四</span>
<span class="hao-cal__dow">五</span>
<span class="hao-cal__dow">六</span>
<span class="hao-cal__dow">日</span>
<button class="hao-cal__day hao-cal__day--out" tabindex="-1">26<i class="hao-moon hao-moon--xs hao-moon--wane" style="--p:0.98"></i></button>
<button class="hao-cal__day hao-cal__day--out" tabindex="-1">27<i class="hao-moon hao-moon--xs hao-moon--wane" style="--p:0.94"></i></button>
<button class="hao-cal__day hao-cal__day--out" tabindex="-1">28<i class="hao-moon hao-moon--xs hao-moon--wane" style="--p:0.89"></i></button>
<button class="hao-cal__day hao-cal__day--out" tabindex="-1">29<i class="hao-moon hao-moon--xs hao-moon--wane" style="--p:0.81"></i></button>
<button class="hao-cal__day hao-cal__day--out" tabindex="-1">30<i class="hao-moon hao-moon--xs hao-moon--wane" style="--p:0.72"></i></button>
<button class="hao-cal__day hao-cal__day--out" tabindex="-1">31<i class="hao-moon hao-moon--xs hao-moon--wane" style="--p:0.62"></i></button>
<button class="hao-cal__day">1<i class="hao-moon hao-moon--xs hao-moon--wane" style="--p:0.52"></i></button>
<button class="hao-cal__day">2<i class="hao-moon hao-moon--xs hao-moon--wane" style="--p:0.41"></i></button>
<button class="hao-cal__day">3<i class="hao-moon hao-moon--xs hao-moon--wane" style="--p:0.31"></i></button>
<button class="hao-cal__day">4<i class="hao-moon hao-moon--xs hao-moon--wane" style="--p:0.21"></i></button>
<button class="hao-cal__day">5<i class="hao-moon hao-moon--xs hao-moon--wane" style="--p:0.13"></i></button>
<button class="hao-cal__day">6<i class="hao-moon hao-moon--xs hao-moon--wane" style="--p:0.07"></i></button>
<button class="hao-cal__day">7<i class="hao-moon hao-moon--xs hao-moon--wane" style="--p:0.03"></i></button>
<button class="hao-cal__day">8<i class="hao-moon hao-moon--xs hao-moon--wane" style="--p:0.00"></i></button>
<button class="hao-cal__day">9<i class="hao-moon hao-moon--xs" style="--p:0.00"></i></button>
<button class="hao-cal__day">10<i class="hao-moon hao-moon--xs" style="--p:0.01"></i></button>
<button class="hao-cal__day">11<i class="hao-moon hao-moon--xs" style="--p:0.04"></i></button>
<button class="hao-cal__day">12<i class="hao-moon hao-moon--xs" style="--p:0.10"></i></button>
<button class="hao-cal__day">13<i class="hao-moon hao-moon--xs" style="--p:0.17"></i></button>
<button class="hao-cal__day">14<i class="hao-moon hao-moon--xs" style="--p:0.26"></i></button>
<button class="hao-cal__day">15<i class="hao-moon hao-moon--xs" style="--p:0.36"></i></button>
<button class="hao-cal__day">16<i class="hao-moon hao-moon--xs" style="--p:0.46"></i></button>
<button class="hao-cal__day">17<i class="hao-moon hao-moon--xs" style="--p:0.57"></i></button>
<button class="hao-cal__day" aria-current="date">18<i class="hao-moon hao-moon--xs" style="--p:0.67"></i></button>
<button class="hao-cal__day">19<i class="hao-moon hao-moon--xs" style="--p:0.76"></i></button>
<button class="hao-cal__day" aria-pressed="true">20<i class="hao-moon hao-moon--xs" style="--p:0.85"></i></button>
<button class="hao-cal__day">21<i class="hao-moon hao-moon--xs" style="--p:0.92"></i></button>
<button class="hao-cal__day">22<i class="hao-moon hao-moon--xs" style="--p:0.97"></i></button>
<button class="hao-cal__day">23<i class="hao-moon hao-moon--xs" style="--p:0.99"></i></button>
<button class="hao-cal__day">24<i class="hao-moon hao-moon--xs hao-moon--wane" style="--p:1.00"></i></button>
<button class="hao-cal__day">25<i class="hao-moon hao-moon--xs hao-moon--wane" style="--p:0.98"></i></button>
<button class="hao-cal__day">26<i class="hao-moon hao-moon--xs hao-moon--wane" style="--p:0.94"></i></button>
<button class="hao-cal__day">27<i class="hao-moon hao-moon--xs hao-moon--wane" style="--p:0.89"></i></button>
<button class="hao-cal__day">28<i class="hao-moon hao-moon--xs hao-moon--wane" style="--p:0.81"></i></button>
<button class="hao-cal__day">29<i class="hao-moon hao-moon--xs hao-moon--wane" style="--p:0.72"></i></button>
<button class="hao-cal__day">30<i class="hao-moon hao-moon--xs hao-moon--wane" style="--p:0.62"></i></button>
</div>
<p class="hao-cal__foot"><span>今天 丙午年十月初十</span><span><i></i>7 日立冬</span><span><i></i>22 日小雪</span></p>
</div>
</div><div class="hao-row" style="gap:var(--hao-space-6);align-items:flex-start">
<div class="hao-cal" data-hao-calendar data-mode="moon" data-today="2026-11-18" data-value="2026-11-20">
<div class="hao-cal__head">
<h2 class="hao-cal__title">November</h2>
<span>
<button class="hao-cal__nav" aria-label="Previous month"><i class="hao-icon hao-icon--chevron-left" aria-hidden="true"></i></button>
<button class="hao-cal__nav" aria-label="Next month"><i class="hao-icon hao-icon--chevron-right" aria-hidden="true"></i></button>
</span>
</div>
<div class="hao-cal__grid">
<span class="hao-cal__dow">M</span>
<span class="hao-cal__dow">T</span>
<span class="hao-cal__dow">W</span>
<span class="hao-cal__dow">T</span>
<span class="hao-cal__dow">F</span>
<span class="hao-cal__dow">S</span>
<span class="hao-cal__dow">S</span>
<button class="hao-cal__day hao-cal__day--out" tabindex="-1">26<i class="hao-moon hao-moon--xs hao-moon--wane" style="--p:0.98"></i></button>
<button class="hao-cal__day hao-cal__day--out" tabindex="-1">27<i class="hao-moon hao-moon--xs hao-moon--wane" style="--p:0.94"></i></button>
<button class="hao-cal__day hao-cal__day--out" tabindex="-1">28<i class="hao-moon hao-moon--xs hao-moon--wane" style="--p:0.89"></i></button>
<button class="hao-cal__day hao-cal__day--out" tabindex="-1">29<i class="hao-moon hao-moon--xs hao-moon--wane" style="--p:0.81"></i></button>
<button class="hao-cal__day hao-cal__day--out" tabindex="-1">30<i class="hao-moon hao-moon--xs hao-moon--wane" style="--p:0.72"></i></button>
<button class="hao-cal__day hao-cal__day--out" tabindex="-1">31<i class="hao-moon hao-moon--xs hao-moon--wane" style="--p:0.62"></i></button>
<button class="hao-cal__day">1<i class="hao-moon hao-moon--xs hao-moon--wane" style="--p:0.52"></i></button>
<button class="hao-cal__day">2<i class="hao-moon hao-moon--xs hao-moon--wane" style="--p:0.41"></i></button>
<button class="hao-cal__day">3<i class="hao-moon hao-moon--xs hao-moon--wane" style="--p:0.31"></i></button>
<button class="hao-cal__day">4<i class="hao-moon hao-moon--xs hao-moon--wane" style="--p:0.21"></i></button>
<button class="hao-cal__day">5<i class="hao-moon hao-moon--xs hao-moon--wane" style="--p:0.13"></i></button>
<button class="hao-cal__day">6<i class="hao-moon hao-moon--xs hao-moon--wane" style="--p:0.07"></i></button>
<button class="hao-cal__day">7<i class="hao-moon hao-moon--xs hao-moon--wane" style="--p:0.03"></i></button>
<button class="hao-cal__day">8<i class="hao-moon hao-moon--xs hao-moon--wane" style="--p:0.00"></i></button>
<button class="hao-cal__day">9<i class="hao-moon hao-moon--xs" style="--p:0.00"></i></button>
<button class="hao-cal__day">10<i class="hao-moon hao-moon--xs" style="--p:0.01"></i></button>
<button class="hao-cal__day">11<i class="hao-moon hao-moon--xs" style="--p:0.04"></i></button>
<button class="hao-cal__day">12<i class="hao-moon hao-moon--xs" style="--p:0.10"></i></button>
<button class="hao-cal__day">13<i class="hao-moon hao-moon--xs" style="--p:0.17"></i></button>
<button class="hao-cal__day">14<i class="hao-moon hao-moon--xs" style="--p:0.26"></i></button>
<button class="hao-cal__day">15<i class="hao-moon hao-moon--xs" style="--p:0.36"></i></button>
<button class="hao-cal__day">16<i class="hao-moon hao-moon--xs" style="--p:0.46"></i></button>
<button class="hao-cal__day">17<i class="hao-moon hao-moon--xs" style="--p:0.57"></i></button>
<button class="hao-cal__day" aria-current="date">18<i class="hao-moon hao-moon--xs" style="--p:0.67"></i></button>
<button class="hao-cal__day">19<i class="hao-moon hao-moon--xs" style="--p:0.76"></i></button>
<button class="hao-cal__day" aria-pressed="true">20<i class="hao-moon hao-moon--xs" style="--p:0.85"></i></button>
<button class="hao-cal__day">21<i class="hao-moon hao-moon--xs" style="--p:0.92"></i></button>
<button class="hao-cal__day">22<i class="hao-moon hao-moon--xs" style="--p:0.97"></i></button>
<button class="hao-cal__day">23<i class="hao-moon hao-moon--xs" style="--p:0.99"></i></button>
<button class="hao-cal__day">24<i class="hao-moon hao-moon--xs hao-moon--wane" style="--p:1.00"></i></button>
<button class="hao-cal__day">25<i class="hao-moon hao-moon--xs hao-moon--wane" style="--p:0.98"></i></button>
<button class="hao-cal__day">26<i class="hao-moon hao-moon--xs hao-moon--wane" style="--p:0.94"></i></button>
<button class="hao-cal__day">27<i class="hao-moon hao-moon--xs hao-moon--wane" style="--p:0.89"></i></button>
<button class="hao-cal__day">28<i class="hao-moon hao-moon--xs hao-moon--wane" style="--p:0.81"></i></button>
<button class="hao-cal__day">29<i class="hao-moon hao-moon--xs hao-moon--wane" style="--p:0.72"></i></button>
<button class="hao-cal__day">30<i class="hao-moon hao-moon--xs hao-moon--wane" style="--p:0.62"></i></button>
</div>
<p class="hao-cal__foot">
<span>Today: lunar month 10, day 10</span>
<span><i></i>Nov 7, Start of Winter</span>
<span><i></i>Nov 22, Minor Snow</span>
</p>
</div>
</div>用法
.hao-cal 里是 .hao-cal__head(宋体月份标题和翻月按钮)、.hao-cal__grid(七列:一行星期,然后是日期按钮 .hao-cal__day),和可选的 .hao-cal__foot。今天加 aria-current="date",选中的加 aria-pressed="true",上下月补位的加 hao-cal__day--out。
日期下面放什么,三选一
| 方式 | 写法 | 样子 |
|---|---|---|
| 农历 | <small class="hao-cal__lunar">初十</small> | 每天一行农历日;初一那天写月名(十月),加 hao-cal__lunar--first;节气那天换成节气名,用不带类名的 <small>,泥金色 |
| 月相 | <i class="hao-moon hao-moon--xs" style="--p:.6"> | 每天一枚小月亮;下半月加 hao-moon--wane,亮面换到左边 |
| 什么都不放 | 最干净,用于只是选个日期的场合 |
- 一个月历里只用一种,不要农历和月相都放,格子装不下。
- 月相的
--p是亮面的比例,0 是朔(初一),1 是望(十五前后)。上半月亮面在右,下半月在左,这是北半球看到的样子。 - 页脚(
.hao-cal__foot)写今天的干支年和农历日;用月相或英文时,把当月的节气也列在这里。 - 英文界面不显示农历文字,用月相;节气在页脚列出英文名。
- 一周从周一开始。英文界面可以按当地习惯从周日开始。
- 今天是
tint色加粗,选中是tint填充;两者重合时按选中显示。 - 方向键在日期间移动,回车选中,翻页键换月。
数据从哪来
- 农历日期不能手写,也不能自己推算,要用历法数据。浏览器和系统自带的国际化接口就有(把日历设为
chinese),能给出月、日和干支年。 - 月相可以由农历日直接换算:初一是朔,十五前后是望。要精确到当天的实际月相,用天文历算库。
- 节气要用历算库或官方发布的表。预览里的立冬、小雪和农历日期,是用系统历法数据生成的 2026 年 11 月。
行为(加载了行为脚本时)
- 给
<div class="hao-cal">加data-hao-calendar,脚本会接管里面的内容,画出真正的月历。属性:data-mode(lunar、moon或plain)、data-value(选中的日期,2026-11-20这样写)、data-today(把「今天」固定在某一天,演示用;不写就是真的今天)、data-terms="off"(不标节气)。 - 翻月按钮可用。点一天就选中它,日历发出
hao-change事件,带上日期和农历。 - 键盘:方向键按天、按周移动,移出本月会自动翻月;Home 和 End 到本周头尾;PageUp 和 PageDown 翻月;回车或空格选中。整个月历只占一个 Tab 停靠点。
- 脚本画出的月历是「表格、行、格」三层结构(
.hao-cal__row一周一行,.hao-cal__cell包着日期按钮),读屏能报出星期几和第几周。 - 每个日期都有完整的读法(年月日、星期、农历、节气)供读屏使用。
- 农历和月相是实时算的,用的是浏览器自带的中国历法数据。浏览器不支持时自动退回不带农历的样子。
- 浏览器的农历数据在极少数日子会差一天。 朔正好落在午夜前后时,它可能把初一算到相邻的那天;实测 2027 年 2 月 6 日它给的是腊月三十,而那天应当是正月初一。日常展示够用;要拿来定节日、算生日这类不能错的事,把
Hairline.calendar.source换成一个接收日期、返回农历的函数,接上权威的历法数据。 - 节气用的是近似算式,个别年份会差一天,只覆盖 2001 到 2100 年。要准确,把
Hairline.calendar.terms换成一个返回历算数据的函数。 - 没有加载脚本时,容器里原来写的静态月历照常显示。