Rails 7中如何为PostgreSQL设置timestamptz的正确时区偏移？

配置与模型信息 #

应用配置：

config.time_zone = 'Vienna' 
config.active_record.default_timezone = :local

模型属性：

date, :timestamptz  # date 是实际列名的简写
date_tz, :string

表单提交的数据（通过 time_zone_select 和 datetime_select）：

"time_zone"=>"Paris","date_f(3i)"=>"12", "date_f(2i)"=>"1", "date_f(1i)"=>"1999", "date_f(4i)"=>"00", "date_f(5i)"=>"00"

目标是在 PostgreSQL 中保存带正确时区偏移的时间数据。

当前控制器的问题 #

控制器能解析 datetime，但卡在设置 local 参数上：

local = ??
datetime = DateTime.civil_from_format(local, params[:date_m(1i)], params[:date_m(2i)], params[:date_m(3i)], params[:date_m(4i)], params[:date_m(5i)], 0)

存在几个核心疑问：

• 对 local 参数的理解模糊：它是不是偏移量字符串？文档说明该方法返回带本地偏移的 DateTime，但没有示例，初步猜测需要 -0400 这类格式的值。
• 这种写法没法处理夏令时（DST）：用户输入了时区，但必须结合具体日期才能得到正确偏移（可能是 -0400 或夏令时的 -0300）。
• ActiveSupport::TimeZone 无法获取偏移量（除首个元素外，其余元素的 @utc_offset=nil），这是不是 application.rb 里的时区配置导致的？

执行 ActiveSupport::TimeZone.all 的输出片段：

> ActiveSupport::TimeZone.all
[#<ActiveSupport::TimeZone:0x00000001143339b0
  @name="International Date Line West",
  @tzinfo=#<TZInfo::DataTimezone: Etc/GMT+12>,
  @utc_offset=nil>,
[...]
#<ActiveSupport::TimeZone:0x000000011597f4d0
  @name="Arizona",
  @tzinfo=#<TZInfo::DataTimezone: America/Phoenix>,
  @utc_offset=nil>,
[...]

解决方案 #

1. 正确获取时区对应的偏移量（考虑夏令时） #

无需手动处理 DateTime.civil_from_format，直接利用 Rails 时区工具处理：

# 从表单参数获取用户选择的时区
user_time_zone = ActiveSupport::TimeZone[params[:time_zone]]
# 拼接用户输入的日期时间字符串
datetime_str = "#{params[:date_f(1i)]}-#{params[:date_f(2i)]}-#{params[:date_f(3i)]} #{params[:date_f(4i)]}:#{params[:date_f(5i)]}:00"
# 将字符串转换为对应时区的时间对象（自动处理夏令时偏移）
local_time = user_time_zone.parse(datetime_str)
# 直接赋值给模型，PostgreSQL 的 timestamptz 会自动存储带偏移的时间
model.date = local_time
model.date_tz = params[:time_zone]
model.save!

2. 关于 ActiveSupport::TimeZone.utc_offset 为 nil 的问题 #

@utc_offset 为 nil 是正常现象——大部分时区的偏移会随夏令时变化，并非固定值。要获取特定日期的偏移量，必须结合具体时间：

# 获取Paris时区在1999年1月12日的偏移量（单位：秒）
tz = ActiveSupport::TimeZone['Paris']
offset = tz.utc_offset(Time.new(1999,1,12))
# 输出示例：3600（对应+0100）

3. 避免手动解析参数的坑 #

Rails 支持自动解析 datetime 参数，只要表单字段命名符合约定：将 datetime 字段命名为 model[date]，配合 time_zone_select 的参数，Rails 会自动结合时区解析出正确的时间对象，无需手动拼接参数。

此外，模型的 date 字段是 timestamptz 类型，PostgreSQL 会自动存储带时区偏移的完整时间信息，无需手动转换偏移字符串。

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