如何使用Gremlin Python存储Java兼容的Long类型时间戳值

问题根源 #

Python中datetime.now().timestamp()返回的是浮点型秒级时间戳，乘以1000后仍为浮点数。直接将该浮点数传递给Gremlin存储时，不仅会触发Java Long类型的类型转换异常，还可能因浮点精度问题导致数值偏差，甚至触发溢出。

解决方案 #

1. 强制转换为整数后传递

将毫秒级时间戳直接转为Python整数，确保Gremlin序列化时映射为Java的Long类型（当前毫秒级时间戳约1.7×10¹²，远小于Java Long的最大值9×10¹⁸，不会触发溢出）。

示例代码：

from gremlin_python.process.traversal import Cardinality
import datetime

# 计算毫秒级时间戳并转为整数
timestamp_ms = int(datetime.now().timestamp() * 1000)
g.addV("xyzzy").property(Cardinality.single, "when", timestamp_ms).next()

2. 避免浮点运算的替代实现

如果担心timestamp()的浮点精度问题，可以通过时间差计算直接得到整数毫秒数：

from gremlin_python.process.traversal import Cardinality
import datetime

now = datetime.datetime.now()
# 计算从1970-01-01至今的总毫秒数，直接得到整数
timestamp_ms = int((now - datetime.datetime(1970, 1, 1)).total_seconds() * 1000)
g.addV("xyzzy").property(Cardinality.single, "when", timestamp_ms).next()

验证兼容性 #

存储完成后，Java端可直接以Long类型读取when字段，Python传递的整数会被Gremlin正确序列化为Java兼容的Long类型。

关键注意事项 #

• 禁止直接传递浮点型时间戳给Gremlin属性，否则会导致类型转换异常或数值偏差；
• 确保时间戳数值在Java Long的合法范围内（-9223372036854775808 至 9223372036854775807），当前毫秒级时间戳完全满足要求。

内容的提问来源于stack exchange，提问作者Manabu Tokunaga