在使用SQLite进行日期时间数据存储时，时区问题是很多开发者都会踩的坑。SQLite本身没有专门的时区数据类型，存储时间时通常以文本、整数或实数的形式保存，默认不会记录时区信息，这就导致不同环境下读取时间时很容易出现偏差。
SQLite DateTime时区问题的成因
SQLite的日期时间函数默认使用当前系统的本地时区，但是存储的时候不会把时区信息一起存进去。比如你在东八区存入一个本地时间，换个西五区的环境读取，函数默认按西五区的时区解析，得到的时间就会差十几个小时。而且如果直接存文本形式的时间，比如2024-05-20 12:00:00，根本没有时区标记，后续根本没法确定它对应的实际时刻。
解决SQLite DateTime时区问题的常用方法
1. 统一使用UTC时间存储
这是最推荐的做法，所有时间都先转换成UTC时间再存入数据库，读取的时候再根据需要的时区转换。SQLite内置的时间函数支持UTC时间处理，示例如下：
-- 插入当前UTC时间，使用datetime函数的'utc'参数
INSERT INTO test_table (create_time) VALUES (datetime('now', 'utc'));
-- 读取时如果需要转换成东八区时间，使用localtime或者指定时区偏移
SELECT datetime(create_time, '+8 hours') AS local_create_time FROM test_table;2. 存储时带上时区偏移信息
如果业务需要保留原始时区，可以在存储时间文本的时候带上偏移量，比如2024-05-20 12:00:00+08:00，这样后续解析的时候可以根据偏移量还原真实时间。不过这种方式的兼容性稍差，需要应用层自己做解析逻辑，示例：
-- 插入带时区偏移的时间文本
INSERT INTO test_table (create_time) VALUES ('2024-05-20 12:00:00+08:00');
-- 读取的时候可以根据偏移量转换，比如转成UTC时间
SELECT datetime(create_time, 'utc') AS utc_create_time FROM test_table;3. 应用层处理时区转换
也可以把SQLite只当作时间数据的存储容器，所有时区转换逻辑放在应用层。比如存储的时候用整数类型存Unix时间戳（秒级或毫秒级），Unix时间戳是全球统一的，不存在时区问题，应用层读取之后再按需要的时区转换显示：
-- 插入当前Unix时间戳（秒级）
INSERT INTO test_table (create_time) VALUES (strftime('%s', 'now'));
-- 读取时间戳，应用层自行转换时区
SELECT create_time FROM test_table;如果用Python处理的话，代码示例如下：
import sqlite3
import datetime
import pytz
# 连接数据库
conn = sqlite3.connect('test.db')
cursor = conn.cursor()
# 写入UTC时间的时间戳
utc_now = datetime.datetime.now(pytz.utc)
timestamp = int(utc_now.timestamp())
cursor.execute("INSERT INTO test_table (create_time) VALUES (?)", (timestamp,))
conn.commit()
# 读取时间戳，转换成东八区时间
cursor.execute("SELECT create_time FROM test_table")
row = cursor.fetchone()
if row:
ts = row[0]
# 转成UTC时间再转东八区
utc_time = datetime.datetime.fromtimestamp(ts, pytz.utc)
local_time = utc_time.astimezone(pytz.timezone('Asia/Shanghai'))
print(f"东八区时间: {local_time.strftime('%Y-%m-%d %H:%M:%S')}")
conn.close()注意事项
- 不要混合使用不同时区的时间存储，整个项目最好统一用一种时间存储规则，避免混乱。
- 如果使用SQLite的
datetime、strftime等函数，要注意函数的时区参数，默认是本地时区，不是UTC。 - 跨时区部署的应用，优先选择UTC时间存储，减少环境差异带来的问题。
只要根据业务场景选对存储和转换方式，SQLite的DateTime时区问题完全可以规避，保证时间数据的准确性。