Raspberry Pi 向Firestore写入时间戳出现+8小时偏移问题

你遇到的这个8小时时间偏差问题，核心根源在于Python的datetime.datetime.now()生成的是不带时区信息的「朴素datetime对象」。Firestore在处理这种无时区的时间时，会默认把它当作UTC时间来存储。

你的本地时区是UTC+8，比如你本地显示的时间是2018-05-20 07:11:19，这个无时区的时间被Firestore误认为是UTC的2018-05-20 07:11:19，当你在Firestore控制台查看时，系统会自动转换为你的本地时区（UTC+8），也就是07:11 + 8小时 = 15:11，这就出现了你看到的时间偏差。

下面给你两种实用的解决办法：

方法1：使用带时区信息的datetime对象 #

生成包含明确时区信息的datetime，告诉Firestore这是你本地时区（或UTC）的时间，避免歧义。数据库存储UTC时间是行业最佳实践，后续显示时再转换为本地时区即可。

修改后的代码示例：

import firebase_admin
from firebase_admin import credentials
from google.cloud import firestore
import datetime

# 初始化Firebase服务
cred = credentials.Certificate('*some key*')
firebase_admin.initialize_app(cred)
db = firestore.client()

# 生成带UTC时区的时间（推荐方案）
now = datetime.datetime.now(datetime.timezone.utc)
# 如果你想直接使用本地时区（UTC+8），可以用下面的代码（需先安装pytz库：pip install pytz）
# import pytz
# now = datetime.datetime.now(pytz.timezone('Asia/Shanghai'))

# 写入Firestore
path = db.collection("*somepath*")
doc_ref = path.document()
doc_ref.set({
    'date': now,
    'rate': 60,
    'used': 1
})
print("current: %s" % now)

方法2：使用Firestore服务器端生成的时间戳 #

如果不需要依赖客户端本地时间（避免客户端时间不准确的情况），可以直接使用Firestore提供的SERVER_TIMESTAMP，让Firestore服务器自动生成精准的UTC时间戳。

修改后的代码示例：

import firebase_admin
from firebase_admin import credentials
from google.cloud import firestore
from google.cloud.firestore import SERVER_TIMESTAMP

# 初始化Firebase服务
cred = credentials.Certificate('*some key*')
firebase_admin.initialize_app(cred)
db = firestore.client()

# 写入Firestore，使用服务器端时间戳
path = db.collection("*somepath*")
doc_ref = path.document()
doc_ref.set({
    'date': SERVER_TIMESTAMP,  # 由Firestore服务器自动生成时间
    'rate': 60,
    'used': 1
})
# 若要查看实际存储的时间，可以后续读取该文档获取

使用上述两种方法后，Firestore存储的时间会和你的预期一致：

• 方法1的UTC时间会被控制台自动转换为你的本地时区显示；
• 方法2的服务器时间戳同样会被正确转换为本地时区展示，且时间精度更高。

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