.NET 8 的 TimeProvider 特性：让你随心所欲地控制时间

目录

示例

结论

---

在 .NET 开发中，我们经常遇到时间和日期相关的问题。这些问题在单元测试中更加棘手，因为需要模拟不同的时间场景来验证的代码逻辑是否正确。

如果直接使用DateTime.Now或DateTimeOffset.Now来获取当前时间，那么测试就会依赖于系统时间，而且很难控制和重现。

那么，有没有什么办法轻松地在单元测试中模拟任意的时间场景呢？.NET 8 引入了一个新的特性，叫做TimeProvider。

TimeProvider 是一个抽象类，它提供了一个统一的接口来获取当前时间和日期。可以通过访问 TimeProvider 的实例，而不是直接使用 DateTime 或 DateTimeOffset 类。

这样，就可以在单元测试中替换 TimeProvider 的实现，来模拟任意的时间场景，而不影响其他代码。

听起来很酷吧？让我们来看看具体的示例吧！

示例

例如，假设有一个类，叫做 OrderService，它负责处理订单相关的逻辑。其中有一个方法，叫做IsOrderExpired，它用订单的过期时间大于当前时间来判断一个订单是否已经过期：

public class OrderService
{
    public bool IsOrderExpired(Order order)
    {
        return order.ExpiryTime < DateTimeOffset.Now;
    }
}

这个方法的单元测试会很困难，因为无法控制当前时间，如果想测试订单的过期时间是否正确设置，那么还需要等待订单过期，这样的测试就不太可靠了。

为了解决这个问题，可以修改 OrderService，让它使用 TimeProvider 来获取当前时间：

 public class OrderService
 {
     private readonly TimeProvider _timeProvider;

     public OrderService(TimeProvider timeProvider)
     {
         _timeProvider = timeProvider;
     }

     public bool IsOrderExpired(Order order)
     {
         return order.ExpiryTime < _timeProvider.GetUtcNow();
     }
 }

最后，使用FakeTimeProvider类（引用 Microsoft.Extensions.TimeProvider.Testing Nuget包）来模拟不同的时间场景：

[TestClass()]
public class OrderServiceTests
{
    [TestMethod()]
    public void IsOrderExpiredTest()
    {
        var order = new Order
        {
            ExpiryTime = DateTimeOffset.UtcNow.AddSeconds(5)
        };

        var timeProvider = new FakeTimeProvider();
        var orderService = new OrderService(timeProvider);

        timeProvider.SetUtcNow(DateTimeOffset.UtcNow);
        Assert.IsFalse(orderService.IsOrderExpired(order));

        timeProvider.SetUtcNow(DateTimeOffset.UtcNow.AddSeconds(5));
        Assert.IsTrue(orderService.IsOrderExpired(order));
    }
}

结论

TimeProvider 是一个很有用的特性，它可以在单元测试中模拟任意的时间场景，而不受系统时间的影响。这样，就可以更方便地验证代码逻辑是否正确，提高代码质量和可维护性。

引入地址