Masuit.Tools 中的 DateTime.GetCurrentWeek 方法问题分析与修复

在软件开发过程中，日期时间处理是一个常见但容易出错的领域。最近在 Masuit.Tools 开源工具库中发现了一个关于 DateTime 扩展方法 GetCurrentWeek 的问题，该方法用于获取当前周的开始和结束时间。

问题描述

GetCurrentWeek 方法设计目的是返回当前周的开始和结束日期，其中开始时间应为当周第一天的 00:00:00，结束时间应为当周最后一天的 23:59:59。然而在实际使用中发现，该方法返回的时间值包含了调用时刻的具体时间信息，而不是预期的纯日期值。

例如，在 2025 年 5 月 12 日调用时，预期应返回：

• 开始时间：2025-05-12 00:00:00
• 结束时间：2025-05-19 23:59:59

但实际返回的是：

• 开始时间：2025-05-12 10:19:46.1393851
• 结束时间：2025-05-19 10:19:45.1393851

问题分析

这个问题源于方法实现时没有正确处理时间部分。在计算周开始和结束时，直接使用了 DateTime.Now 的当前时间，而没有将时间部分重置为当天的开始或结束时刻。

正确的实现应该：

1. 获取当前日期，忽略时间部分
2. 计算当周的第一天（根据文化设置可能是周日或周一）
3. 设置开始时间为当天的 00:00:00
4. 设置结束时间为下周第一天的前一天的 23:59:59

解决方案

修复后的实现应该确保：

• 开始时间的时间部分总是 00:00:00
• 结束时间的时间部分总是 23:59:59
• 考虑不同文化下的周起始日设置（有些文化以周日为一周开始，有些以周一）

典型的修复方式是在计算后使用 Date 属性获取纯日期部分，然后添加适当的时间：

var start = date.AddDays(-(int)date.DayOfWeek).Date; // 假设周日为一周开始
var end = start.AddDays(7).AddSeconds(-1);

最佳实践建议

在处理日期时间范围时，建议：

1. 明确区分"日期"和"日期时间"的概念
2. 对于范围查询，开始时间通常包含在内，结束时间通常不包含
3. 考虑使用 DateTime.Date 属性获取纯日期部分
4. 对于周计算，考虑文化差异，最好提供重载方法允许指定周起始日

总结

日期时间处理是软件开发中的常见痛点，即使是经验丰富的开发者也可能在边界条件上犯错。这个案例提醒我们，在实现日期时间相关功能时，要特别注意时间部分的处理，并考虑不同文化环境下的差异。通过这次修复，Masuit.Tools 的 GetCurrentWeek 方法现在能够更准确地返回预期的周范围，为开发者提供了更可靠的日期处理工具。