日期函数
下面列出了所有知心插件中与日期相关的工具函数，每个函数均可直接在 Excel 中调用。本文档详细介绍每个函数的功能、调用语法、参数说明以及使用示例，帮助用户快速上手使用这些日期工具。
1 计算这天所在月份的天数 (zd_days_in_month)
该函数用于计算指定日期所在月份的总天数。 Excel 调用语法：
=zd_days_in_month(date)
参数说明：
date (可选)：日期，可以为数字或字符串格式，默认值为“今天”。 支持的日期格式包括： - 20240101 - 2024-01-01 - 2024/01/01 - 2024/1/1 - 2024-1-1
返回值： 返回指定日期所在月份的天数（如 31）。
使用示例：
=zd_days_in_month("20250101") // 返回 31
=zd_days_in_month(2026/1/1) // 返回 31
2 计算这天所在年份的天数 (zd_days_in_year)
该函数用于计算指定日期所在年份的总天数。 Excel 调用语法：
=zd_days_in_year(date)
参数说明：
date (可选)：日期，支持多种格式，默认值为“今天”。
返回值： 返回指定日期所在年份的天数（例如：365 或 366）。
使用示例：
=zd_days_in_year("20250101") // 返回 365
=zd_days_in_year(2020/1/1) // 返回 366
3 计算这天是本周第几天 (zd_day_of_week)
该函数用于确定指定日期在本周中的顺序，周一返回 1，周日返回 7。 Excel 调用语法：
=zd_day_of_week(date)
参数说明：
date (可选)：日期，支持数字或字符串格式，默认值为“今天”。
返回值： 返回一个数字，表示该日期在一周中的顺序（1 至 7）。
使用示例：
=zd_day_of_week("20250101") // 返回 3
=zd_day_of_week(2026/1/1) // 返回 4
4 计算这天是本月的第几周 (zd_week_of_month)
该函数用于计算指定日期在其所在月份中的周次。 Excel 调用语法：
=zd_week_of_month(date)
参数说明：
date (可选)：日期，支持多种格式，默认值为“今天”。
返回值： 返回一个数字，表示该日期是本月的第几周。
使用示例：
=zd_week_of_month("20250101") // 返回 1
=zd_week_of_month(2026/1/1) // 返回 1
5 计算这天是该年第几周 (zd_week_of_year)
该函数用于计算指定日期在其所在年份中的周次（可能为 53 或 54 周）。 注意： 元旦或元旦之后几天可能属于上一年的最后一周，使用时请结合年份进行判断。 Excel 调用语法：
=zd_week_of_year(date)
参数说明：
date (可选)：日期，支持数字或字符串格式，默认值为“今天”。
返回值： 返回一个数字，表示该日期是该年第几周。
使用示例：
=zd_week_of_year("20250101") // 返回 1
=zd_week_of_year(2026/1/1) // 返回 53
6 计算这天是该年第几季 (zd_quarter_of_year)
该函数用于确定指定日期所在的季度。 Excel 调用语法：
=zd_quarter_of_year(date)
参数说明：
date (可选)：日期，支持多种格式，默认值为“今天”。 例如：1 月 1 日至 3 月 31 日为第一季。
返回值： 返回一个数字，表示该日期所在的季度（1 至 4）。
使用示例：
=zd_quarter_of_year("20250101") // 返回 1
=zd_quarter_of_year(2026/4/1) // 返回 2
7 将 Unix 纪元时间戳转换为日期 (zd_EpochToDate)
该函数用于将 Unix 纪元时间戳（支持秒、毫秒或微秒）转换为 UTC 日期时间格式。 Excel 调用语法：
=zd_EpochToDate(timestamp, [time_unit])
参数说明：
timestamp (必需)：Unix 纪元时间戳，支持秒、毫秒或微秒。
time_unit (可选，默认 1)：表示时间戳的单位 - 1：秒 - 2：毫秒 - 3：微秒
返回值： 返回转换后的 UTC 日期时间字符串（格式如 “yyyy-mm-dd HH:MM:SS”）。
使用示例：
=zd_EpochToDate(1655906568893, 2) // 返回 "2022-06-22 12:02:48"
8 计算两个日期之间的差值 (zd_DateDif)
该函数用于计算两个日期之间的差值，支持天、月、年等多种单位。 Excel 调用语法：
=zd_DateDif(start_date, end_date, unit)
参数说明：
start_date (必需)：开始日期，可以是 DATE 类型的单元格引用、函数返回值或数字。
end_date (必需)：结束日期，同上。
unit (必需)：时间单位缩写，例如： - “Y”：年 - “M”：月 - “D”：天 - “MD”、”YM”、”YD”：用于更精细的日期差计算
返回值： 返回两个日期之间的差值，单位由参数 unit 决定。
使用示例：
=zd_DateDif(DATE(1969, 7, 16), DATE(1969, 7, 24), "D") // 返回 8