课表是怎么做的

起因
这学期课表比较复杂,周一到周五每天十几节课,还有晚自习,周五下午单双周还轮着上不同科目。手动记容易出错,于是想着能不能把这个课表挂到博客上,随时随地就能查。
数据结构
课表的核心是 src/data/timetable.ts,两个数组:
periods:作息时间,定义每一大节的起止时间和标签courses:课程列表,每条记录包含课程名、星期几、第几大节、上课周次规则、地点、教师
周次规则通过 weeks 字段控制,支持三种模式:
{ start: 1, end: 21 }— 全部周次{ start: 1, end: 21, parity: "odd" }— 单周{ start: 1, end: 21, parity: "even" }— 双周
这周五下午就是靠 parity 实现的:单周第一节化学,双周第一节体育,其余课程不变。
另外,单双周只负责描述常规教学周,不直接承担节假日判断。semester.dateOverrides 单独保存日期覆盖规则:
{ type: "holiday", start: "2026-10-01", end: "2026-10-07", name: "国庆节" }— 假期内不上课{ type: "makeup", date: "2026-10-10", scheduleDay: 5, scheduleWeek: 5 }— 指定日期按星期五第 5 周课表补课
调休规则优先于假期规则,所以落在假期区间内的补课日仍会正常显示对应课程。假期按具体日期生效,只会压制对应星期的课程,不会影响同一周其他日期;调休的 scheduleWeek 只用于匹配单双周,不会改变页面按自然教学周显示的当前周次。
排课过程
按时间表逐天录入,day: 1-5 对应周一到周五,slot 对应 periods 的下标。13 个时段分别是:
| 早读1 | 早读2 | 上午1-4 | 中午1-2 | 下午1-4 | 晚自习 |
|---|---|---|---|---|---|
| 07:00-07<25>25> | 07:25-07<50>50> | 08:00-11<41>41> | 12:00-13<30>30> | 13:40-17<20>20> | 17:45-20<30>30> |
周二到周五的课程顺序和周一不同,逐一核对后填入对应 slot。地点和教师目前留空,后续补上。
学期信息
semester 配置了学期的基本信息:startDate 是实际开学日 2026-09-01(周二),firstWeekMonday 是学校规定的第一周周一 2026-08-31,totalWeeks 为 21 周。
周次只以 firstWeekMonday 为锚点计算,因此每周一 00<00>00> 切换到下一周,不会因为开学日是周二而延迟到周二切换。startDate 仅用于判断“是否已经开学”,两者职责分开。
边界计算已覆盖跨月、周日到周一、开学前、学期结束后、假期区间和调休补课,可运行 pnpm test:timetable 验证。
效果预览
课表页面在 /timetable 路由下,桌面端是表格形式展示,手机端切换为按天列表。课程卡片会自动分配颜色,不同科目不同颜色,一眼就能分辨。
后续
- 补上教室和教师信息
- 如果以后有科目调整,直接改
timetable.ts即可,不需要动代码
文章分享
如果这篇文章对你有帮助,欢迎分享给更多人!


