日期和时间转换

日期和时间以多种格式和配置出现，通常需要针对数据存储系统、报表、网页等进行转换。APOC 日期函数允许用户获取这些 Long 或 String 类型的值，并根据不同的格式需求进行操作。

如果您需要将日期对象类型转换为其他格式，请参阅时间函数 (Temporal Functions)。

关于日期和时间格式的说明

默认格式为 yyyy-MM-dd HH:mm:ss
如果格式模式中未指定时区，格式化程序将默认日期属于 UTC 时区
如果指定了时区模式，则会从日期字符串中提取时区，否则将报错
to/fromSeconds 时间戳值基于 POSIX（Unix 时间）系统，即时间戳表示自 1970 年 1 月 1 日星期四 00:00:00 UTC 以来经过的秒数
完整支持的格式列表请参见 SimpleDateFormat JavaDoc

过程概览

下表描述了可用的过程：

限定名称类型

限定名称	类型
apoc.date.add `apoc.date.add(time INTEGER, unit STRING, addValue INTEGER, addUnit STRING)` - 将指定时间单位的值添加到给定的时间戳中。	`函数`
apoc.date.convert `apoc.date.convert(time INTEGER, unit STRING, toUnit STRING)` - 将给定的时间戳从一个时间单位转换为不同时间单位的时间戳。	`函数`
apoc.date.convertFormat `apoc.date.convertFormat(temporal STRING, currentFormat STRING, convertTo STRING)` - 将一种类型的日期格式 `STRING` 转换为另一种类型的日期格式 `STRING`。	`函数 (Function) Cypher 25 中已弃用`
apoc.date.currentTimestamp `apoc.date.currentTimestamp()` - 返回当前的 Unix 纪元时间戳（毫秒）。	`函数 (Function) Cypher 25 中已弃用`
apoc.date.field `apoc.date.field(time INTEGER, unit STRING, timezone STRING)` - 从给定的日期时间返回一个字段的值。	`函数 (Function) Cypher 25 中已弃用`
apoc.date.fields `apoc.date.fields(date STRING, pattern STRING)` - 将给定的日期拆分为字段，并返回一个包含每个字段值的 `MAP`。	`函数 (Function) Cypher 25 中已弃用`
apoc.date.format `apoc.date.format(time INTEGER, unit STRING, format STRING, timezone STRING)` - 返回时间值的 `STRING` 表示。时间单位（默认：毫秒）、日期格式（默认：ISO）和时区（默认：当前时区）都可以更改。	`函数 (Function) Cypher 25 中已弃用`
apoc.date.fromISO8601 `apoc.date.fromISO8601(time STRING)` - 将给定的日期 `STRING` (ISO8601) 转换为表示时间值的 `INTEGER`（毫秒）。	`函数 (Function) Cypher 25 中已弃用`
apoc.date.parse `apoc.date.parse(time STRING, unit STRING, format STRING, timezone STRING)` - 将给定的日期 `STRING` 从指定格式解析为指定的时间单位。	`函数 (Function) Cypher 25 中已弃用`
apoc.date.systemTimezone `apoc.date.systemTimezone()` - 返回系统时区的显示名称（例如 Europe/London）。	`函数`
apoc.date.toISO8601 `apoc.date.toISO8601(time INTEGER, unit STRING)` - 返回 ISO8601 格式的指定时间值的 `STRING` 表示。	`函数 (Function) Cypher 25 中已弃用`
apoc.date.toYears `apoc.date.toYears(value ANY, format STRING)` - 将给定的时间戳或日期转换为表示年份的 `FLOAT`。	`函数`

apoc.date.add
apoc.date.add(time INTEGER, unit STRING, addValue INTEGER, addUnit STRING) - 将指定时间单位的值添加到给定的时间戳中。

函数

apoc.date.convert
apoc.date.convert(time INTEGER, unit STRING, toUnit STRING) - 将给定的时间戳从一个时间单位转换为不同时间单位的时间戳。

函数

apoc.date.convertFormat
apoc.date.convertFormat(temporal STRING, currentFormat STRING, convertTo STRING) - 将一种类型的日期格式 STRING 转换为另一种类型的日期格式 STRING。