Django 在 USE_TZ=True 时，所有 datetime 字段存入数据库前均转为 UTC：带时区对象直接转 UTC，naive 时间按 TIME_ZONE 解释后再转；务必用 timezone.now() 而非 datetime.now()，外部输入需显式绑定时区。
USE_TZ=True 时 Django 怎么存时间到数据库
Django 在 USE_TZ=True 下，所有 datetime 字段（如 DateTimeField）接收的值会被自动转成 UTC 后存入数据库。哪怕你传的是带本地时区的 datetime 对象，Django ORM 也会先调用 .astimezone(timezone.utc) 再保存；如果传的是“naive”时间（没时区），Django 会按 TIME_ZONE 配置当作本地时间解释，再转 UTC 存。
常见错误现象：ValueError: Can't localize naive datetime —— 多出现在模板里用 {{ obj.created_at|date }} 但 created_at 是 naive 时间且 USE_TZ=True；或者你在 shell 里手动创建对象时写了 datetime.now() 而不是 timezone.now()。
- 始终用
timezone.now()替代datetime.now()创建带时区的时间 - 从外部（如 API、表单）接收时间字符串时，用
parse_datetime()或make_aware()显式绑定时区，别直接strptime - 数据库里看到的
2024-05-20 12:00:00+00是 UTC，不是服务器本地时间 —— 别误以为它“错了”
前端显示怎么变成用户本地时间（不靠 JS）
Django 模板层能自动把 UTC 时间转成请求用户的本地时区，前提是开启中间件和正确设置 TIME_ZONE，且用户时区已知。
使用场景：用户登录后设置了个人时区（比如存在 user.timezone 字段），或通过 pytz/zoneinfo 解析请求头里的 Accept-Language 或 IP 地理位置（不推荐自动猜）。
立即学习“Python免费学习笔记（深入）”；
- 在视图里用
timezone.activate(user.timezone)激活用户时区，之后所有模板过滤器（如|date、|time）都会基于该时区渲染 - 确保
MIDDLEWARE包含'django.contrib.auth.middleware.AuthenticationMiddleware'和自定义的时区激活中间件（比如读取用户 profile） -
TIME_ZONE配置只是 fallback，默认时区，不是全局生效的“显示时区”
为什么 model.save() 后取出来时间看起来“变慢了 8 小时”
这是最常被误解的现象：数据库里存的是 UTC，而你用 python manage.py dbshell 直接查，看到的是原始 UTC 值；但你在 shell 或 admin 里打印 obj.updated_at，Django 默认会调用 __str__ 并触发本地化（按 TIME_ZONE 或当前激活时区转），所以看起来“变了”。本质是显示逻辑不同，不是数据错了。
性能影响：每次访问 datetime 字段属性时，Django 都会做一次时区转换（如果未激活时区，则用 TIME_ZONE）。频繁读写时间字段且大量调用 .isoformat() 或 .strftime() 的地方要注意——尽量复用已转换的对象，别反复调。
- 调试时用
obj.updated_at.replace(tzinfo=None)看原始值（UTC 秒数不变） - 避免在循环里对同一字段反复调用
.astimezone()，提前转好缓存 - PostgreSQL 的
timestamptz类型和 SQLite 的文本存储对 Django 透明，不用手动干预类型
API 返回 JSON 时怎么让时间字段自动转本地时区
Django REST Framework 默认序列化 DateTimeField 时，会输出 ISO 8601 格式字符串，且带 +00:00（即 UTC）。它**不会**自动按用户时区转——因为 JSON 响应本身无上下文，DRF 不知道该转给谁。
容易踩的坑：前端拿到 "2024-05-20T04:30:00Z" 后用 new Date() 解析，浏览器自动转成本地时间，看似“对了”，但这是 JS 行为；如果你后端想返回带用户时区偏移的字符串（如 "2024-05-20T12:30:00+08:00"），必须手动处理。
- 在 serializer 的
to_representation里对时间字段调用value.astimezone(user_timezone)再格式化 - 不要覆盖全局
DateTimeField的to_representation，只针对需要本地化的字段定制 - 注意：这种做法会让缓存失效更频繁，且无法利用 DRF 的
DateTimeField内置格式化选项（如format参数）
