如何在Rust sqlx与time库的场景下，让PostgreSQL按指定时区返回时间戳

我完全理解你的困扰——用sqlx 0.7.3搭配time 0.3.34时，PostgreSQL的timestamptz字段总是以UTC返回，想让数据库直接按用户时区返回结果，试过SET TIME ZONE却因为sqlx的二进制协议限制没效果，确实头疼。

下面给你几个可行的解决方案，结合你的场景逐一分析：

方案一：在SQL中显式转换每个时间字段（纯数据库层面处理） #

由于sqlx的query_as采用PostgreSQL的二进制协议，这个协议下timestamptz始终以UTC时间戳传输，会话时区设置（SET TIME ZONE）不会生效，所以只能在SQL语句里对每个时间字段做显式转换。

1. 查询场景 #

把每个timestamptz字段用AT TIME ZONE转换为目标时区的时间，示例：

SELECT 
  id,
  created_at AT TIME ZONE $1 AS created_at,
  date_time AT TIME ZONE $1 AS date_time,
  score
  -- 其他字段依次列出
FROM games

然后在Rust代码里绑定用户时区参数（比如"Europe/Berlin"）：

let user_timezone = "Europe/Berlin";
let query = r#"SELECT id, created_at AT TIME ZONE $1 AS created_at, date_time AT TIME ZONE $1 AS date_time, score FROM games"#;
let games = sqlx::query_as::<_, Game>(query)
    .bind(user_timezone)
    .fetch_all(db_connection)
    .await?;

2. 带RETURNING的场景（比如INSERT/CTE） #

哪怕是CTE末尾的RETURNING *，也需要逐个指定字段并转换，示例：

WITH new_game AS (
  INSERT INTO "games" ("id", "created_at", "date_time", "score")
  VALUES ($1, $2, $3, $4)
  RETURNING *
)
SELECT 
  id,
  created_at AT TIME ZONE $5 AS created_at,
  date_time AT TIME ZONE $5 AS date_time,
  score
FROM new_game

同样绑定用户时区参数即可。

这种方法的缺点是如果结构体字段很多，SQL语句会变得冗长，但确实能让数据库直接返回目标时区的时间。

方案二：用PostgreSQL视图封装固定时区转换（适合单一时区场景） #

如果你的服务只需要适配固定几个时区，可以提前创建视图封装转换逻辑，比如针对柏林时区：

CREATE VIEW games_berlin AS
SELECT 
  id,
  created_at AT TIME ZONE 'Europe/Berlin' AS created_at,
  date_time AT TIME ZONE 'Europe/Berlin' AS date_time,
  score
  -- 其他字段
FROM games;

之后直接查询视图即可：

let query = "SELECT * FROM games_berlin";
let games = query.build_query_as::<Game>().fetch_all(db_connection).await?;

但这个方案只适合时区固定的场景，无法动态适配不同用户的时区。

方案三：在Rust层做时区转换（最灵活的方案） #

虽然你一开始想在数据库层面处理，但考虑到sqlx的二进制协议限制，Rust层转换其实是更简洁、灵活的选择——毕竟不需要修改复杂的SQL语句，尤其是字段多或有复杂CTE的情况。

利用time库（或搭配time-tz）可以轻松把UTC的OffsetDateTime转换为用户时区的时间：

use time::{OffsetDateTime, TimeZone};
use time_tz::Tz; // 需要先在Cargo.toml添加time-tz依赖

// 解析用户的时区（比如从请求头或用户配置获取）
let user_tz: Tz = "Europe/Berlin".parse().unwrap();

// 遍历查询到的games，转换时间字段
let mut games_local: Vec<Game> = games.into_iter().map(|mut game| {
    // 将created_at转换为用户时区的OffsetDateTime
    game.created_at = game.created_at.to_offset(user_tz.offset_at(game.created_at));
    // 或者转换为不带时区的PrimitiveDateTime（如果业务不需要保留时区信息）
    // game.created_at = game.created_at.to_offset(user_tz).date_time().assume_offset(user_tz.offset_at(game.created_at));
    game.date_time = game.date_time.to_offset(user_tz.offset_at(game.date_time));
    game
}).collect();

这个方案不需要修改任何SQL，不管是SELECT *还是RETURNING *都能直接用，后期维护成本更低。

为什么SET TIME ZONE没用？ #

再补充一下你之前遇到的问题原因：sqlx的query_as使用PostgreSQL的二进制协议传输数据，这个协议下timestamptz类型会被序列化为UTC时间戳，完全不受会话时区（SET TIME ZONE设置的）影响，只有当你用文本协议（比如直接执行SELECT并获取字符串结果）时，会话时区才会生效。

备注：内容来源于stack exchange，提问作者Fred Hors