如何判断DateTimeOffset是否为指定TimeSpan的时间间隔点

原方案的问题 #

你之前的实现只依赖TimeSpan.Minutes属性，存在两个致命问题：

1. 粒度覆盖不全：只能处理分钟级间隔，无法支持秒、小时等其他粒度的需求
2. 除零异常：当TimeSpan的分钟数为0时（比如1小时间隔），会触发除零错误

正确实现思路 #

核心逻辑是：计算目标时间距离当天0点的总时间刻度，然后和间隔TimeSpan的总刻度取模，结果为0则说明是间隔点。这种方式不依赖TimeSpan的单个属性，支持任意粒度的间隔判断。

代码实现 #

// 针对DateTime的判断方法
bool IsIntervalPoint(DateTime time, TimeSpan interval)
{
    var timeSinceMidnight = time.TimeOfDay;
    return timeSinceMidnight.Ticks % interval.Ticks == 0;
}

// 针对DateTimeOffset的判断方法（兼容时区）
bool IsIntervalPoint(DateTimeOffset time, TimeSpan interval)
{
    var timeSinceMidnight = time.TimeOfDay;
    return timeSinceMidnight.Ticks % interval.Ticks == 0;
}

// 测试用例
var fiveMinuteInterval = TimeSpan.FromMinutes(5);
Console.WriteLine(IsIntervalPoint(new DateTime(2022,11,18,9,0,0), fiveMinuteInterval)); // 输出 True
Console.WriteLine(IsIntervalPoint(new DateTime(2022,11,18,9,05,0), fiveMinuteInterval)); // 输出 True
Console.WriteLine(IsIntervalPoint(new DateTime(2022,11,18,9,03,0), fiveMinuteInterval)); // 输出 False

var fiveSecondInterval = TimeSpan.FromSeconds(5);
Console.WriteLine(IsIntervalPoint(new DateTime(2022,11,18,9,0,0), fiveSecondInterval)); // 输出 True
Console.WriteLine(IsIntervalPoint(new DateTime(2022,11,18,9,0,5), fiveSecondInterval)); // 输出 True
Console.WriteLine(IsIntervalPoint(new DateTime(2022,11,18,9,0,3), fiveSecondInterval)); // 输出 False

var oneHourInterval = TimeSpan.FromHours(1);
Console.WriteLine(IsIntervalPoint(new DateTime(2022,11,18,9,0,0), oneHourInterval)); // 输出 True
Console.WriteLine(IsIntervalPoint(new DateTime(2022,11,18,9,30,0), oneHourInterval)); // 输出 False

扩展说明 #

• 如果需要跨天的固定间隔（比如从2020-01-01 00:00开始的每5小时间隔），可以把timeSinceMidnight替换为time - new DateTime(2020,1,1)，再取模即可
• 所有判断基于Ticks（.NET中时间的最小精确单位），避免了浮点运算的精度问题

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