如何在Ruby/Rails中解析和生成HTML week元素的周字符串？

HTML提供了周选择器<input type="week">，它会生成类似2026-W05（代表2026年第5周）的ISO 8601格式字符串。我尝试用Ruby的strptime/strftime方法配合"%G-W%V"格式来解析和生成这类字符串，但用MDN上的示例测试时没有得到预期结果，相关代码和测试情况如下：

测试代码 #

class DateHelper
  # 解析HTML周选择器提供的字符串
  def self.parse_iso8601_week(string)
    Date.strptime(string, "%G-W%V").all_week
  end

  def self.to_iso8601_week(date_range)
    date_range.first.strftime("%G-W%V")
  end
end

describe DateHelper, "ISO 8601（HTML规范）周转换" do
  RSpec.shared_examples "转换测试" do |iso_week, start_date, end_date|
    it do
      result = DateHelper.parse_iso8601_week(iso_week)
      # 转换为日期范围
      expect(result).to eq start_date.to_date..end_date.to_date
      # 转换回原字符串
      expect(DateHelper.to_iso8601_week(result)).to eq iso_week
    end
  end

  include_examples "转换测试", "2001-W37", "2001-09-10", "2001-09-16"
  include_examples "转换测试", "1953-W01", "1952-12-29", "1953-01-04"
  include_examples "转换测试", "1948-W53", "1948-12-27", "1949-01-02"
  include_examples "转换测试", "1949-W01", "1949-01-03", "1949-01-09"
end

测试结果 #

DateHelper ISO 8601（HTML规范）周转换
  is expected to eq "2001-W37"
  is expected to eq Mon, 29 Dec 1952..Sun, 04 Jan 1953 (FAILED - 1)
  example at ./spec/lib/date_helper_spec.rb:83 (FAILED - 2) # Date::Error: invalid date
  is expected to eq "1949-W01"

编辑说明：该问题仅出现在我的应用环境中，发布前忘记单独运行代码，抱歉！

解决方案 #

问题出在Ruby的%G/%V格式符的解析逻辑，以及Railsall_week的默认周起始规则上，以下是修正后的可靠实现：

修正后的DateHelper类 #

class DateHelper
  ISO_WEEK_FORMAT = "%G-W%V"

  # 解析HTML周选择器字符串，返回ISO标准的周一至周日日期范围
  def self.parse_iso8601_week(string)
    # 拆分年份和周数
    year, week = string.split("-W").map(&:to_i)
    # 使用Date.commercial获取该ISO周的周一（ISO周以周一为起始日）
    week_start = Date.commercial(year, week, 1)
    # 构建周一到周日的范围
    week_start..week_start + 6.days
  end

  # 将日期范围转回ISO 8601周字符串
  def self.to_iso8601_week(date_range)
    date_range.first.strftime(ISO_WEEK_FORMAT)
  end
end

关键修正点 #

1. 改用Date.commercial处理ISO周：Ruby的Date.commercial是专门为ISO周设计的方法，直接通过年份、周数、星期几（1代表周一）生成对应日期，能完美处理跨年周的情况，避免strptime解析时的异常。
2. 手动构建日期范围：Rails的all_week默认以周日为一周起始，不符合ISO 8601的周定义（ISO周以周一为起始），手动构建周一+6天的范围能保证和HTML周选择器的逻辑一致。
3. 避免格式符解析歧义：%G代表ISO周的年份，和公历年份可能不一致（比如1953-W01的ISO年份是1953，但起始日期在1952年），Date.commercial能直接处理这种差异。

验证效果 #

修正后的代码可以通过所有测试用例：

• 1953-W01会正确解析为1952-12-29至1953-01-04的范围
• 1948-W53不再抛出Date::Error异常
• 双向转换均能保持字符串一致性

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