当前时间戳

函数名：time_当前时间戳 / tm_Timestamp

功能描述

获取当前系统时间的 Unix 时间戳，支持返回 10 位秒级或 13 位毫秒级时间戳。

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

语法

=time_当前时间戳(精度)

参数

参数名	类型	必填	默认值	说明
精度	Boolean	否	TRUE	TRUE=返回 13 位毫秒级时间戳，FALSE=返回 10 位秒级时间戳

返回值

String - 当前时间的 Unix 时间戳字符串。异常时返回 #VALUE!。

使用示例

获取当前毫秒级时间戳

公式：

=time_当前时间戳()

结果：

1723027234567

获取当前秒级时间戳

公式：

=time_当前时间戳(FALSE)

结果：

1723027234

生成唯一标识

公式：

="ID_" & time_当前时间戳()

结果：

ID_1723027234567

技术说明

• 使用 DateTimeOffset.Now 获取当前本地时间。
• 精度 为 TRUE（默认）时调用 ToUnixTimeMilliseconds() 返回 13 位毫秒级时间戳。
• 精度 为 FALSE 时调用 ToUnixTimeSeconds() 返回 10 位秒级时间戳。
• 返回值为字符串类型，避免 Excel 自动转为科学计数法显示。

错误处理

错误场景	返回值
正常执行	当前 Unix 时间戳字符串
异常错误	#VALUE!