tm_WeekDay函数
函数名：time_星期几 / tm_WeekDay
函数功能
返回指定日期对应的星期几（中文显示），支持文本格式日期和Excel日期序列值。
参数规范
| 参数名 | 类型 | 必填 | 示例 | 特殊说明 |
|---|---|---|---|---|
dateInput | String/Double | 是 | "2025-07-18" / 45000 | 支持日期字符串或Excel日期序列号 |
使用案例
文本日期输入
问题描述：获取文本日期对应的星期几 公式演示：
excel
=tm_WeekDay("2025-07-18")输出效果（示例）：
星期五Excel日期序列输入
问题描述：获取Excel日期序列对应日期的星期几 公式演示：
excel
=tm_WeekDay(45000)输出效果（示例）：
星期五无效日期格式
问题描述：输入错误的日期格式时返回提示 公式演示：
excel
=tm_WeekDay("invalid_date")输出效果：
无效的日期格式技术说明
日期解析逻辑
- 支持字符串和数值输入
- 字符串优先尝试直接解析为日期
- 失败后尝试将字符串转换为Excel日期数值后解析
- 数值输入视为Excel日期序列号转换为日期
星期几映射
- 返回中文星期表示
- 以
DayOfWeek枚举值映射为星期日至星期六
异常处理
| 错误场景 | 返回值 |
|---|---|
| 输入类型不支持 | "不支持的输入类型" |
| 无效日期格式 | "无效的日期格式" |
| 代码异常 | "转换失败" |
扩展应用
自动日期校验
结合该函数可实现日期格式校验及星期信息自动展示。
工作计划辅助
在排班或项目管理中快速获得日期对应的星期，方便排程。
注：本函数已在WPS 2019+和Excel 365中测试通过。