你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn

DateTimeToTimestamp(NoSQL 查询)

适用范围: NoSQL

将指定的日期和时间转换为数字时间戳。 时间戳是带符号数字整数,用于度量自 Unix 纪元以来的毫秒数。

语法

DateTimeToTimestamp(<date_time>)

参数

描述
date_time 采用 ISO 8601 格式 YYYY-MM-DDThh:mm:ss.fffffffZ 的协调世界时 (UTC) 日期和时间字符串。

注意

有关 ISO 8601 格式的详细信息,请参阅 ISO 8601

返回类型

返回一个有符号的数值,即自 Unix 纪元(1970 年 1 月 1 日)以来当前已经过的毫秒数。

注意

有关 Unix 纪元的详细信息,请参阅 Unix 时间

示例

以下示例将日期和时间“2015 年 5 月 19 日 12:00 UTC”转换为时间戳。

SELECT VALUE {
    timestamp: DateTimeToTimestamp("2015-05-19T12:00:00.0000000")
}
[
  {
    "timestamp": 1432036800000
  }
]

注解

  • 如果日期和时间不是有效的 ISO 8601 日期和时间字符串,则此函数会返回 undefined