Oracle TO_CHAR函数周计算异常咨询：年末日期周归属不符

在日历中，2025年和2026年的12月30日、31日均属于同一周，但使用Oracle的TO_CHAR函数生成年周字段时，得到的周数却不一致。执行的SQL语句如下：

select
    to_char(to_date('30-12-2025','dd-mm-yyyy'),'yyyy-ww')
    , to_char(to_date('31-12-2025','dd-mm-yyyy'),'yyyy-ww')
    , to_char(to_date('30-12-2026','dd-mm-yyyy'),'yyyy-ww')
    , to_char(to_date('31-12-2026','dd-mm-yyyy'),'yyyy-ww')
 from dual;

数据库中存在结束日期为2025年12月30日、31日的订单，另一张表存储了按周维度的数据（如2025-01至2025-53）。关联两张表时，2025年12月30日的订单无法关联到2025-53，但该日期实际属于第53周。

另外，尝试使用ISO周格式时，2026年12月31日能得到预期的2026-53，但2025年12月31日会得到2025-01（错误使用yyyy-iw时）或2026-01（使用标准iyyy-iw时），均不符合实际业务需求。已切换德语、英语日期语言，尝试dd-mm-rr或dd-mm-yyyy日期格式，问题依然存在。

请问Oracle为何会出现该行为？

1. WW格式符的核心计算规则 #

Oracle的WW格式符按固定7天周期划分年周，逻辑如下：

• 每年第1周从当年1月1日开始，每连续7天为一个周，一年最多包含53周。
• 平年有365天（52×7+1），最后1天单独划为第53周；闰年366天（52×7+2），最后2天划为第53周。

2. 两年年末周数差异的具体原因 #

2025年（平年，1月1日为周三）

• 第52周覆盖12月24日-12月30日（刚好是当年第358天到第364天，52×7=364天），因此12月30日属于第52周。
• 12月31日是当年第365天，单独成为第53周。

2026年（平年，1月1日为周四）

• 第52周覆盖12月23日-12月29日（当年第357天到第363天）。
• 12月30日（第364天）和12月31日（第365天）都属于第53周。

这种基于固定7天周期的划分，直接导致了两年年末日期的周数差异。

3. ISO周不适用的原因 #

ISO周（IW格式符）的规则是：

• 每周从周一开始，第1周是包含当年1月4日的周，且该周至少包含4天的新年度。
• 2025年12月31日属于2026年的第1周（因为2026年1月4日在该周内）：
  • 若使用yyyy-iw，会错误保留2025年，周数显示为01；
  • 若使用标准ISO年周格式iyyy-iw，会显示为2026-01，不符合你希望该日期归属2025年第53周的需求。

自定义年周计算方案 #

如果需要让2025年12月30日、31日均归属2025年第53周，可以用以下逻辑统一处理年末日期：

SELECT
    TO_CHAR(dt, 'yyyy') || '-' || 
    CASE
        -- 将当年最后7天的日期统一标记为第53周
        WHEN dt >= ADD_MONTHS(TRUNC(dt, 'yyyy'), 12) - INTERVAL '6' DAY THEN '53'
        ELSE TO_CHAR(dt, 'WW')
    END AS custom_year_week
FROM (
    SELECT TO_DATE('30-12-2025', 'dd-mm-yyyy') dt FROM dual
    UNION ALL
    SELECT TO_DATE('31-12-2025', 'dd-mm-yyyy') dt FROM dual
);

该SQL可解决订单与周维度表的关联问题。

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