tm_ToDateTimeStamp函数
函数名：time_日期转时间戳 / tm_ToDateTimeStamp
函数功能
将日期时间字符串或Excel日期值转换为Unix时间戳，支持返回10位秒级或13位毫秒级时间戳字符串。
参数规范
| 参数名 | 类型 | 必填 | 示例 | 特殊说明 |
|---|---|---|---|---|
dateInput | Object | 是 | "2023-01-01 12:00:00" / 44927.5 | 支持日期时间字符串或Excel序列日期数值 |
milliseconds | Bool | 否 | TRUE | 是否返回13位毫秒级，默认TRUE；否则返回10位秒级 |
使用案例
日期字符串转换为毫秒级时间戳
问题描述：将标准日期时间字符串转换为13位Unix时间戳 公式演示：
excel
=tm_ToDateTimeStamp("2023-01-01 12:00:00")输出效果（示例）：
1672574400000Excel日期值转换为秒级时间戳
问题描述：将Excel序列日期转换为10位Unix时间戳 公式演示：
excel
=tm_ToDateTimeStamp(44927.5, FALSE)输出效果（示例）：
1672574400无效输入处理
问题描述：处理无效的日期格式输入 公式演示：
excel
=tm_ToDateTimeStamp("abc123")输出效果：
无效的日期格式技术说明
输入类型支持
- 字符串类型，自动尝试解析为日期时间
- 数值类型，按Excel日期序列号转换
- 其他类型返回不支持的输入类型提示
时间戳计算
- 使用
DateTimeOffset计算Unix时间戳 - 根据
milliseconds参数返回13位或10位时间戳
异常处理
| 错误场景 | 返回值 |
|---|---|
| 无效日期格式 | 无效的日期格式 |
| 不支持的输入类型 | 不支持的输入类型 |
| 其他异常 | 转换失败 |
扩展应用
批量日期转时间戳
结合数组公式批量转换日期，方便日志和时间序列数据处理。
时间格式兼容性
支持Excel日期和标准日期字符串，增强灵活性。
注：本函数在WPS 2019+和Excel 365环境中测试通过。