apoc.date.format
函数在 Cypher 25 中已弃用

此函数已弃用。请改用 Cypher 的 format() 函数。
详细信息

语法

apoc.date.format(time [, unit, format, timezone ])

描述

返回时间值的 STRING（字符串）表示形式。可以更改时间单位（默认值：ms）、日期格式（默认值：ISO）和时区（默认值：当前时区）。

参数

名称

类型

描述

time

INTEGER（整数）

要格式化的自纪元以来的时间戳。

unit

STRING

给定时间戳的单位。默认值为：ms。

format

STRING

将给定时间值转换为的格式。默认值为：yyyy-MM-dd HH:mm:ss。

timezone

STRING

给定时间戳所属的时区。默认值为空（``）。

返回

STRING

使用示例

unit 参数支持以下值

  • ms, milli, millis, milliseconds（毫秒）

  • s, second, seconds（秒）

  • m, minute, minutes（分钟）

  • h, hour, hours（小时）

  • d, day, days（天）

format 参数支持在 Java DateTime 格式化和解析模式下定义的格式值。

timezone 参数可以使用 GMT 或数据库（文本）名称指定，具体列表请参阅 时区列表

以下代码将以纪元毫秒为单位的日期时间转换为 yyyy-MM-dd 格式

apoc.date.format
WITH datetime("2020-11-04T11:23:22").epochMillis AS datetime
RETURN apoc.date.format(datetime, "ms", "yyyy-MM-dd") AS output;
Cypher 的 format 函数
RETURN format(datetime("2020-11-04T11:23:22"), "yyyy-MM-dd") AS output;
结果
输出

"2020-11-04"

以下代码将以纪元毫秒为单位的 GMT 日期时间转换为 yyyy-MM-dd’T’HH:mm:ssz 格式，并使用 Australian/Sydney 时区

apoc.date.format
WITH datetime("2020-11-04T11:23:22+00:00").epochMillis AS datetime
RETURN apoc.date.format(datetime, "ms", "yyyy-MM-dd'T'HH:mm:ssz", "Australia/Sydney") AS output;
Cypher 的 format 函数
WITH datetime("2020-11-04T11:23:22+00:00") AS datetime
RETURN format(datetime({datetime: datetime, timezone: "Australia/Sydney"}), "yyyy-MM-dd'T'HH:mm:ssz") AS output;
结果
输出

"2020-11-04T22:23:22AEDT"