PHP开发中如何在Neo4j使用带时区的DateTime字段？

嘿，我刚好处理过类似的PHP+Neo4j时区时间存储的场景，给你几个靠谱的解决方案，既能存带时区的时间，又能避免字符串查询的麻烦：

Neo4j本身就支持带时区的DateTime原生类型，这是最省心的方案——不用自己处理字符串解析，查询时能直接用Neo4j的时间函数做比较、范围查询，效率还高。

存储示例（PHP端） #

用官方Neo4j PHP驱动的\Neo4j\Driver\Types\DateTime类，直接把PHP的DateTimeImmutable转成Neo4j兼容的类型：

// 初始化带时区的PHP DateTime对象
$phpDateTime = new DateTimeImmutable('2024-05-20 14:30:00', new DateTimeZone('Asia/Shanghai'));
// 转成Neo4j DateTime类型
$neo4jDateTime = \Neo4j\Driver\Types\DateTime::fromDateTime($phpDateTime);

// 执行Cypher语句存储
$session = $driver->session();
$session->run("CREATE (e:Event {happenedAt: $neo4jDateTime})");

查询示例（Cypher） #

直接用datetime()函数和原生字段做对比，完全不用处理字符串：

MATCH (e:Event)
// 查询上海时区2024年5月20日之后的事件
WHERE e.happenedAt > datetime('2024-05-20T00:00:00+08:00')
RETURN e.id, e.happenedAt

如果因为某些原因没法用原生DateTime（比如老版本驱动或数据兼容需求），可以分开存毫秒级时间戳和时区标识符字符串，查询时再转换为带时区的时间。

存储示例（PHP端） #

$phpDateTime = new DateTimeImmutable('now', new DateTimeZone('Europe/Paris'));
// 存毫秒级时间戳
$timestamp = $phpDateTime->getTimestamp() * 1000;
// 存时区名称（比如Europe/Paris）
$timezone = $phpDateTime->getTimezone()->getName();

$session->run("CREATE (e:Event {occurredTs: $timestamp, timezone: $timezone})");

查询示例（Cypher） #

用datetime()函数把时间戳和时区转成原生类型再做查询：

MATCH (e:Event)
WHERE datetime({epochMillis: e.occurredTs, timezone: e.timezone}) < datetime('2024-05-21T00:00:00+01:00')
RETURN e

• 确保你用的是官方Neo4j PHP驱动（neo4j/neo4j-php-driver），版本建议2.0以上，对原生时间类型的支持更完善。
• 尽量避免存成格式化字符串（比如2024-05-20T14:30:00+08:00），不仅查询时要额外解析，还容易出现格式不一致的问题。

内容的提问来源于stack exchange，提问作者Jaime Roman