tm_TimestampToDate函数
函数名：time_时间戳转日期 / tm_TimestampToDate
函数功能
将Unix时间戳转换为格式化的日期时间字符串，支持10位秒级和13位毫秒级时间戳输入。
参数规范
| 参数名 | 类型 | 必填 | 示例 | 特殊说明 |
|---|---|---|---|---|
timestamp | Double | 是 | 1672531199 | 支持10位秒级或13位毫秒级Unix时间戳 |
format | String | 否 | "yyyy-MM-dd HH:mm:ss" | 日期时间格式字符串，默认yyyy-MM-dd HH:mm:ss |
使用案例
秒级时间戳转换
问题描述：将10位秒级时间戳转换为标准日期时间 公式演示：
excel
=tm_TimestampToDate(1672531199)输出效果（示例）：
2023-01-01 00:59:59毫秒级时间戳转换及自定义格式
问题描述：将13位毫秒级时间戳转换为指定格式日期 公式演示：
excel
=tm_TimestampToDate(1672531199123, "yyyy/MM/dd HH:mm")输出效果（示例）：
2023/01/01 00:59错误时间戳处理
问题描述：处理无效时间戳 公式演示：
excel
=tm_TimestampToDate(-1234567890)输出效果：
无效的时间戳技术说明
时间戳识别规则
- 大于等于
1e12视为13位毫秒级时间戳 - 小于
1e12视为10位秒级时间戳 - 使用
DateTimeOffset类转换为本地时间
格式说明
- 格式字符串遵循.NET标准日期时间格式，例如
yyyy-MM-dd HH:mm:ss - 可自定义返回格式
异常处理
| 错误场景 | 返回值 |
|---|---|
| 时间戳格式错误或无法解析 | 无效的时间戳 |
扩展应用
时间戳批量转换
结合Excel数组功能，实现批量时间戳转换，方便日志或时间序列分析。
自定义显示格式
支持多种日期格式，适配不同业务需求，如只显示日期或仅显示时间。
注：本函数在WPS 2019+和Excel 365环境中测试通过。