如何将日期字符串转为firestore.SERVER_TIMESTAMP以实现Firestore分页查询？

问题核心 #

你的timestamp_date字段存储的是Firestore的SERVER_TIMESTAMP，本质是**google.cloud.firestore.Timestamp类型对象**，而非字符串。直接传入ISO格式字符串会因类型不匹配导致查询失效，必须将字符串转换为对应的Timestamp对象。

解决方案 #

方法1：使用dateutil.parser解析（推荐，兼容Python3.6） #

借助python-dateutil库自动解析ISO格式时间字符串，再转换为Firestore Timestamp：

1. 先安装依赖（如果未安装）：

pip install python-dateutil

2. 转换并查询的代码：

from google.cloud import firestore
from dateutil import parser

# 解析ISO时间字符串为带时区的datetime对象
dt = parser.parse(input_date_variable)
# 转换为Firestore Timestamp类型
firestore_timestamp = firestore.Timestamp.from_datetime(dt)

# 执行分页查询
query_docs = query_forward.start_at({
    u'timestamp_date': firestore_timestamp
}).stream()

方法2：手动解析（无需额外依赖） #

如果不想引入第三方库，可手动处理UTC时区的时间字符串：

from google.cloud import firestore
from datetime import datetime
import pytz

# 处理UTC时间字符串，移除末尾的时区标识
dt_str = input_date_variable.replace('+00:00', '')
# 按格式解析为datetime对象
dt = datetime.strptime(dt_str, '%Y-%m-%dT%H:%M:%S.%f')
# 设置时区为UTC
dt = dt.replace(tzinfo=pytz.UTC)
# 转换为Firestore Timestamp类型
firestore_timestamp = firestore.Timestamp.from_datetime(dt)

# 执行分页查询
query_docs = query_forward.start_at({
    u'timestamp_date': firestore_timestamp
}).stream()

关键说明 #

• Firestore的SERVER_TIMESTAMP在存储时会被转换为Timestamp对象，查询时必须传入同类型的值才能匹配。
• 确保转换后的datetime对象包含正确的时区信息（UTC），否则会出现时间偏移导致查询结果不准确。

内容的提问来源于stack exchange，提问作者Jack tileman