灵析表格

Appearance

tm_WeekOfYear函数 ​

函数名：time_年度周数 / tm_WeekOfYear

函数功能 ​

计算指定日期在一年中的周数，支持输入日期文本或Excel日期序列值。

参数规范 ​

参数名类型必填示例特殊说明
dateInputString/Double是"2025-07-18" / 45000支持日期字符串或Excel日期序列号

使用案例 ​

文本日期输入 ​

问题描述：获取指定文本日期的年度周数 公式演示：

excel
=tm_WeekOfYear("2025-07-18")

输出效果（示例）：

29

Excel日期序列输入 ​

问题描述：获取Excel日期序列对应日期的周数 公式演示：

excel
=tm_WeekOfYear(45000)

输出效果（示例）：

29

无效日期格式 ​

问题描述：输入错误的日期格式时返回提示 公式演示：

excel
=tm_WeekOfYear("invalid_date")

输出效果：

无效的日期格式

技术说明 ​

日期解析逻辑 ​

  • 支持字符串和数值输入
  • 字符串优先尝试直接解析为日期
  • 若解析失败，尝试将字符串转换为Excel日期数值再解析
  • 数值输入视为Excel日期序列号，转换为对应日期

周数计算规则 ​

  • 使用当前系统区域文化 CultureInfo.CurrentCulture
  • 以CalendarWeekRule.FirstDay规则和星期一作为每周起始日

异常处理 ​

错误场景返回值
输入类型不支持"不支持的输入类型"
无效日期格式"无效的日期格式"
代码异常#VALUE!

扩展应用 ​

周报统计 ​

结合该函数，可轻松实现年度周报自动分组统计。

多区域适配 ​

自动适配系统区域文化，适用不同国家和地区的周数计算规则。

注：本函数在WPS 2019+和Excel 365环境中测试通过。