C#实现与SQL DATEDIFF(ww)一致的日期周数差函数问询

我太懂这个坑了！之前为了让C#计算的周数差和SQL Server的datediff(ww)完全对齐，折腾了好一阵子——关键是得先吃透SQL的计算规则，再在C#里精准复刻它。

先搞懂SQL Server datediff(ww)的核心逻辑 #

SQL Server的datediff(ww, startDate, endDate)本质是按以下规则计算：

1. 每周以周日作为第一天；
2. 结果是两个日期各自所属周的起始日（该周的周日）之间的完整周数差，简单说就是统计两个日期之间跨越了多少个周日边界。
   比如你举的例子：2018-04-13（周五）属于2018-04-08开始的周，2018-04-16（周一）属于2018-04-15开始的周，两个起始日差7天，所以结果为1。

为什么你之前的方法不行？ #

• 用TotalDays / 7只看总天数，完全不考虑周边界，自然不符合SQL的规则；
• 直接用DateTimeFormatInfo.GetWeekOfYear如果不指定正确的日历规则，会和SQL冲突——.NET默认的周规则（比如ISO周）是周一开头，且第一周要求至少4天在当年，和SQL的规则完全不一样，跨年时必然出错。

完美对齐SQL的C#实现 #

话不多说，直接上代码：

首先写一个辅助函数，获取某日期对应的SQL风格周起始日（即该日期所在周的周日）：

private static DateTime GetSqlWeekStartDate(DateTime date)
{
    // SQL以周日为一周第一天，计算需要往前推几天到最近的周日
    int daysToSubtract = (int)date.DayOfWeek;
    // 注意：如果date本身是周日，daysToSubtract为0，直接返回当天
    return date.AddDays(-daysToSubtract).Date;
}

然后是核心的周数差计算函数：

public static int SqlDateDiffWeek(DateTime startDate, DateTime endDate)
{
    // 先把两个日期转换为各自的SQL周起始日
    DateTime startWeek = GetSqlWeekStartDate(startDate);
    DateTime endWeek = GetSqlWeekStartDate(endDate);
    
    // 计算两个起始日的天数差，除以7得到周数差
    TimeSpan weekDiff = endWeek - startWeek;
    return (int)(weekDiff.TotalDays / 7);
}

这个函数完全遵循SQL的规则，包括：

• 自动处理跨年份的情况（比如2023-12-30到2024-01-01会返回1，和SQL一致）；
• 当startDate晚于endDate时，返回负数，和SQL的datediff行为一致；
• 忽略时间部分，只对比日期（因为用了.Date属性）。

测试关键场景 #

1. 你的示例：

   int diff = SqlDateDiffWeek(new DateTime(2018,4,13), new DateTime(2018,4,16));
   // 返回1，和SQL结果一致
   

2. 跨年场景：

   int crossYearDiff = SqlDateDiffWeek(new DateTime(2023,12,30), new DateTime(2024,1,1));
   // 返回1，SQL执行`datediff(ww,'2023-12-30','2024-01-01')`也会得到1
   

3. 同一周内的日期：

   int sameWeekDiff = SqlDateDiffWeek(new DateTime(2018,4,15), new DateTime(2018,4,21));
   // 返回0，因为都属于2018-04-15开始的周
   

内容的提问来源于stack exchange，提问作者André Luiz