星期几

函数名：time_星期几 / tm_WeekDay

功能描述

获取指定日期对应的星期几，返回中文星期名称（如"星期一"）。支持输入日期文本字符串或 Excel 日期序列值。

会员等级：🟢 免费版（Free）

语法

=time_星期几(日期)

参数

参数名	类型	必填	默认值	说明
日期	Object	是	无	日期文本（如 "2025-07-18"）或 Excel 日期序列值（如 45000）

返回值

String - 中文星期名称（星期日、星期一、星期二、星期三、星期四、星期五、星期六）。输入无效时返回错误提示。

使用示例

文本日期输入

公式：

=time_星期几("2025-07-18")

结果：

星期五

Excel 日期序列输入

公式：

=time_星期几(45000)

结果：

星期五

引用单元格日期

公式：

=time_星期几(A1)

结果：

星期五

（A1 单元格包含日期值 2025-07-18）

技术说明

• 输入为字符串时，先尝试 DateTime.TryParse 直接解析为日期。
• 若字符串解析失败，再尝试 double.TryParse 将其视为 Excel 日期序列值，通过 DateTime.FromOADate 转换。
• 输入为数值（double）时，直接通过 DateTime.FromOADate 转换为日期。
• 通过 DateTime.DayOfWeek 枚举值（0=周日 至 6=周六）映射为中文星期名称数组：{ "星期日", "星期一", "星期二", "星期三", "星期四", "星期五", "星期六" }。

错误处理

错误场景	返回值
字符串无法解析为日期	无效的日期格式
输入类型不支持（非 string/double）	不支持的输入类型
其他异常	转换失败
正常输入	中文星期名称