工具调用次数已接近上限，我已完成必要的源码研究，现在直接输出文章。

桌面应用跨平台【免费下载链接】nodeguiA library for building cross-platform native desktop applications with Node.js and CSS . React NodeGui : https://react.nodegui.org and Vue NodeGui: https://vue.nodegui.org项目地址https://gitcode.com/gh_mirrors/no/nodegui点击查看免费下载DayOfWeek 枚举详解NodeGui 中星期常量与日历控件的实战用法导读DayOfWeek是 NodeGui基于 Node.js 和 CSS 构建跨平台原生桌面应用的库提供的一个星期枚举用于以类型安全的方式表示周一到周日并驱动QCalendarWidget等日期类控件的行为。本文围绕 dayofweek.md 中的枚举成员定义结合 QCalendarWidget 源码 与 QDate 源码 的调用链完整说明每个成员的数值含义、导入方式以及setFirstDayOfWeek、QDate.dayOfWeek()等真实 API 的用法。读完本文你将掌握在 NodeGui 桌面应用中正确使用星期枚举、设置日历首日、以及解析日期星期数的完整方案。一、枚举定义速览NodeGui 将 Qt 的Qt::DayOfWeek枚举重新封装为 TypeScript 枚举定义于 DayOfWeek/index.ts与 API 文档 中列出的 7 个成员完全一致成员数值说明Monday1星期一Tuesday2星期二Wednesday3星期三Thursday4星期四Friday5星期五Saturday6星期六Sunday7星期日数值映射的三个关键事实数值从 1 开始与 Qt 对齐Monday 1而非 0。这与许多其他语言/库如 JavaScript 原生Date.getDay()返回0表示星期日不同使用时需注意区分。周日是 7 而不是 0Sunday 7这是 Qt 的Qt::DayOfWeek约定对应Qt::Sunday与 ISO 8601 星期编号习惯一致。枚举通过统一入口导出所有枚举类型都在 QtEnums/index.ts 中集中导出第 22 行export { DayOfWeek } from ./DayOfWeek;因此你只需要从nodegui/nodegui的顶层导出中按需引入无需记忆深层路径。二、如何引入与使用 DayOfWeek1. 从包入口导入在 NodeGui 应用中推荐从包顶层直接解构导入import { DayOfWeek, QCalendarWidget, QDate } from nodegui/nodegui; // 或者使用 CommonJS // const { DayOfWeek, QCalendarWidget, QDate } require(nodegui/nodegui);2. 最典型的消费场景QCalendarWidget.setFirstDayOfWeek()DayOfWeek在仓库中最直接的实战用途是设置QCalendarWidget的每周起始日。源码位于 QCalendarWidget.ts 第 51-56 行setFirstDayOfWeek(dayOfWeek: DayOfWeek): void { this.setProperty(firstDayOfWeek, dayOfWeek); } firstDayOfWeek(): DayOfWeek { return this.property(firstDayOfWeek).toInt(); }setFirstDayOfWeek接收DayOfWeek枚举值将其写入 Qt 原生属性firstDayOfWeek读取时firstDayOfWeek()通过property(...).toInt()返回对应的枚举成员。实际例子——让日历以周一开始import { DayOfWeek, QCalendarWidget, QMainWindow } from nodegui/nodegui; const win new QMainWindow(); const calendar new QCalendarWidget(); // 设置每周从星期一开始显示 calendar.setFirstDayOfWeek(DayOfWeek.Monday); // 验证设置 console.log(calendar.firstDayOfWeek()); // 输出 1 win.setCentralWidget(calendar); win.show();若把一周的起始日改为周日只需calendar.setFirstDayOfWeek(DayOfWeek.Sunday);3. 与 QDate.dayOfWeek() 搭配使用除了日历控件DayOfWeek的数值语义还与QDate的dayOfWeek()方法一一对应。QDate.ts 第 32-34 行dayOfWeek(): number { return this.native.dayOfWeek(); }该方法返回的整数1 星期一…7 星期日与DayOfWeek枚举值完全一致因此你可以把两者结合判断某个日期是星期几import { QDate, DayOfWeek } from nodegui/nodegui; const date QDate.currentDate(); const dow date.dayOfWeek(); if (dow DayOfWeek.Monday) { console.log(今天是周一); } else if (dow DayOfWeek.Sunday) { console.log(今天是周日); }注意QDate.dayOfWeek()的 TypeScript 声明返回类型为number而非DayOfWeek在严格类型检查下可做一次断言dow as DayOfWeek或直接按数值比较。三、枚举到原生层的传递源码调用链佐证DayOfWeek并不仅是一个“装饰性”的类型它在 NodeGui 中被真实地传递到底层 Qt 属性系统。以日历控件为例调用链如下TypeScript 层QCalendarWidget.ts 中setFirstDayOfWeek(dayOfWeek: DayOfWeek)调用this.setProperty(firstDayOfWeek, dayOfWeek)将枚举数值如 1写入 QObject 属性C 包装层qcalendarwidget_wrap.cpp 通过 N-APINapi注册QCalendarWidget类并将其注册进 WrapperCache第 31 行QOBJECT_REGISTER_WRAPPER(QCalendarWidget, QCalendarWidgetWrap)Qt 原生层属性最终作用于底层QCalendarWidget其首日类型即为Qt::DayOfWeek从而控制日历网格的排列起点。这条链路说明枚举成员数值必须严格对应 Qt 的Qt::DayOfWeek取值1~7任何自定义数值都会导致首日设置与预期不符。此外QDate.dayOfWeek()的原生实现可直接佐证数值来源——qdate_wrap.cpp 第 100-103 行Napi::Value QDateWrap::dayOfWeek(const Napi::CallbackInfo info) { Napi::Env env info.Env(); return Napi::Value::From(env, this-instance-dayOfWeek()); }它直接转发 QtQDate::dayOfWeek()的返回值1 Monday7 Sunday与DayOfWeek枚举一一对应。四、项目中的其他引用位置快速定位如果你在阅读或调试 NodeGui 代码时遇到DayOfWeek以下位置值得关注DayOfWeek/index.ts枚举定义本体QtEnums/index.ts统一导出入口第 22 行QCalendarWidget.ts唯一直接消费该枚举的控件类setFirstDayOfWeek/firstDayOfWeekQDate.tsdayOfWeek()返回与枚举同构的数值qcalendarwidget_wrap.cpp原生包装注册处。五、常见坑位与最佳实践不要与Date.getDay()混淆原生 JavaScript 的getDay()中0是周日而DayOfWeek.Sunday 7。跨层转换时务必显式映射避免“差一天”的 bug。优先使用枚举而非魔法数字calendar.setFirstDayOfWeek(1)虽然可行参数实际按数字传入但可读性差且容易写错推荐始终使用DayOfWeek.Monday这种具名形式。断言返回值类型firstDayOfWeek()与QDate.dayOfWeek()的声明返回类型为number/DayOfWeek时按需断言可规避严格模式下的类型报错。设置首日后通过 getter 验证调用setFirstDayOfWeek后可立即用firstDayOfWeek()读回属性确认设置生效如上节示例所示。结语DayOfWeek是 NodeGui 中数量众多但极易被忽略的基础枚举之一。它的 7 个成员Monday 1至Sunday 7不仅是日历控件设置起始日的核心参数也与QDate.dayOfWeek()的返回值构成一一对应的契约。掌握它的数值约定与引入方式是正确使用QCalendarWidget、QDate等日期相关组件的前提。配合 API 文档、枚举源码 与 日历控件源码你可以在自己的 NodeGui 桌面应用中自由定制星期相关的日历行为。赞分享桌面应用跨平台【免费下载链接】nodeguiA library for building cross-platform native desktop applications with Node.js and CSS . React NodeGui : https://react.nodegui.org and Vue NodeGui: https://vue.nodegui.org项目地址https://gitcode.com/gh_mirrors/no/nodegui点击查看免费下载相关推荐结合已完成的源码级调研直接输出文章结合已完成的源码级调研直接输出文章 K3s 本地 Agentic 工作流实战基于 .agents/AGENTS.md 的 Dependabot Action云原生容器编排集群管理边缘计算容器运行时基于源码研究已完成信息收集。现在输出文章。基于源码研究已完成信息收集。现在输出文章。 ClickHouse v26.2.10.10 stable 版本发布解读TCP 连接池内核缓冲监控、嵌入式客户端数据库OLAP列式数据库大数据实时分析数据分析Salt Player 歌词显示设置命名规则、自动匹配与参数速查完整指南Salt Player 歌词显示设置命名规则、自动匹配与参数速查完整指南 深夜跑高速单曲循环一首老 FLAC。文件里没有内嵌歌词手机里也没有 .lrc播上一篇DeepGlobe道路提取挑战终极指南3分钟掌握高精度道路识别技术下一篇Lance 文档贡献指南主站构建、本地预览与多语言 API 文档发布全流程创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考