Claude Skill

time-provider

How code reads the current time through TimeProvider instead of DateTime.UtcNow, where the system clock is registered, and how tests fix the clock with FakeTimeProvider. Use when code needs the current date or time, sets a created or modified date, or a test depends on time.

LLM Mart · 0 points · 0 views 0 listing impressions 0 install-command copies
Download leanmeancleanapps-cleanminimalapi-.agents_skills_time-provider-fd0b4df.zip · 1 KB

Install

skills CLI npx skills add https://github.com/LeanMeanCleanApps/CleanMinimalApi/tree/main/.agents/skills/time-provider
Claude Code claude plugin marketplace add https://llmmart.ai/marketplace.json && claude plugin install leanmeancleanapps-cleanminimalapi@llmmart
Git git clone https://github.com/LeanMeanCleanApps/CleanMinimalApi.git

The skills CLI installs just this skill, for any of its supported agents. Claude Code installs the whole leanmeancleanapps/cleanminimalapi collection as a plugin from our marketplace. Git is the plain clone.

Skill manifest

Time provider

The rule

Nothing reads the clock directly. Code that needs the time takes TimeProvider through its constructor and calls GetUtcNow(). Production gets TimeProvider.System, registered with TryAddSingleton in AddInfrastructure only. The system clock is an outside dependency, and Infrastructure owns those; Application only uses the abstract TimeProvider, which is part of .NET and needs no package. Every host calls AddInfrastructure, and TryAdd lets a host or test register its own clock first. Tests pass a FakeTimeProvider (Microsoft.Extensions.TimeProvider.Testing) set to a fixed moment, so every date is known in advance.

Times are stored and compared in UTC. Two things read the clock today. The repository stamps DateCreated and DateModified on writes, and LoggingBehaviour times each request with GetTimestamp() and GetElapsedTime().

Steps

  1. Take TimeProvider timeProvider in the constructor, check it with ArgumentNullException.ThrowIfNull, and keep it in a private readonly field.
  2. Read the time once per operation into a local (var now = this.timeProvider.GetUtcNow().UtcDateTime;) and use that value everywhere in the operation, so created and modified dates match.
  3. In repository tests, use the clock from MovieReviewsTestDatabase (fixed at 2009-12-31 23:51:01 UTC) and assert against it.
  4. To test something that depends on time passing, call Advance(TimeSpan) on the fake. LoggingBehaviourTests advance it inside the fake next delegate, so the logged time is exact.

Example

// src/Infrastructure/Databases/MovieReviews/EntityFrameworkMovieReviewsRepository.cs
public async Task<bool> UpdateReview(Guid id, int stars, CancellationToken cancellationToken)
{
    var now = this.timeProvider.GetUtcNow().UtcDateTime;

    var updated = await this.context.Reviews
        .Where(r => r.Id == id)
        .ExecuteUpdateAsync(
            setters => setters
                .SetProperty(r => r.Stars, stars)
                .SetProperty(r => r.DateModified, now),
            cancellationToken);

    return updated > 0;
}
// tests/Infrastructure.Tests.Integration/Databases/MovieReviews/EntityFrameworkMovieReviewsRepositoryTests.cs
updatedReview.DateModified.ShouldBe(this.database.TimeProvider.GetUtcNow().UtcDateTime);

Don't

  • Call DateTime.Now, DateTime.UtcNow or DateTimeOffset.UtcNow in src.
  • Read the time more than once in one operation.
  • Store local times.
  • Assert a date with a tolerance ("within a second of now"). Fix the clock and assert the exact value.

The one exception, in a solution with authentication, is the test that creates a token for the real JWT handler, which checks expiry against the system clock (tests/Presentation.Tests.Integration/Authentication/AuthenticationTests.cs).

Check

grep -rn "DateTime.UtcNow\|DateTime.Now\|DateTimeOffset.UtcNow" src   # expect no output
dotnet test tests/Infrastructure.Tests.Integration
Files (cleanminimalapi)
  • SKILL.md 3.3 KB
    ---
    name: time-provider
    description: How code reads the current time through TimeProvider instead of DateTime.UtcNow, where the system clock is registered, and how tests fix the clock with FakeTimeProvider. Use when code needs the current date or time, sets a created or modified date, or a test depends on time.
    metadata:
      scope: shared
    ---
    
    # Time provider
    
    ## The rule
    
    Nothing reads the clock directly. Code that needs the time takes `TimeProvider` through its constructor and calls `GetUtcNow()`. Production gets `TimeProvider.System`, registered with `TryAddSingleton` in `AddInfrastructure` only. The system clock is an outside dependency, and Infrastructure owns those; Application only uses the abstract `TimeProvider`, which is part of .NET and needs no package. Every host calls `AddInfrastructure`, and `TryAdd` lets a host or test register its own clock first. Tests pass a `FakeTimeProvider` (`Microsoft.Extensions.TimeProvider.Testing`) set to a fixed moment, so every date is known in advance.
    
    Times are stored and compared in UTC. Two things read the clock today. The repository stamps `DateCreated` and `DateModified` on writes, and `LoggingBehaviour` times each request with `GetTimestamp()` and `GetElapsedTime()`.
    
    ## Steps
    
    1. Take `TimeProvider timeProvider` in the constructor, check it with `ArgumentNullException.ThrowIfNull`, and keep it in a `private readonly` field.
    2. Read the time once per operation into a local (`var now = this.timeProvider.GetUtcNow().UtcDateTime;`) and use that value everywhere in the operation, so created and modified dates match.
    3. In repository tests, use the clock from `MovieReviewsTestDatabase` (fixed at 2009-12-31 23:51:01 UTC) and assert against it.
    4. To test something that depends on time passing, call `Advance(TimeSpan)` on the fake. `LoggingBehaviourTests` advance it inside the fake `next` delegate, so the logged time is exact.
    
    ## Example
    
    ```csharp
    // src/Infrastructure/Databases/MovieReviews/EntityFrameworkMovieReviewsRepository.cs
    public async Task<bool> UpdateReview(Guid id, int stars, CancellationToken cancellationToken)
    {
        var now = this.timeProvider.GetUtcNow().UtcDateTime;
    
        var updated = await this.context.Reviews
            .Where(r => r.Id == id)
            .ExecuteUpdateAsync(
                setters => setters
                    .SetProperty(r => r.Stars, stars)
                    .SetProperty(r => r.DateModified, now),
                cancellationToken);
    
        return updated > 0;
    }
    ```
    
    ```csharp
    // tests/Infrastructure.Tests.Integration/Databases/MovieReviews/EntityFrameworkMovieReviewsRepositoryTests.cs
    updatedReview.DateModified.ShouldBe(this.database.TimeProvider.GetUtcNow().UtcDateTime);
    ```
    
    ## Don't
    
    - Call `DateTime.Now`, `DateTime.UtcNow` or `DateTimeOffset.UtcNow` in `src`.
    - Read the time more than once in one operation.
    - Store local times.
    - Assert a date with a tolerance ("within a second of now"). Fix the clock and assert the exact value.
    
    The one exception, in a solution with authentication, is the test that creates a token for the real JWT handler, which checks expiry against the system clock (`tests/Presentation.Tests.Integration/Authentication/AuthenticationTests.cs`).
    
    ## Check
    
    ``` bash
    grep -rn "DateTime.UtcNow\|DateTime.Now\|DateTimeOffset.UtcNow" src   # expect no output
    dotnet test tests/Infrastructure.Tests.Integration
    ```
    

Comments (0)

Sign in to join the conversation.

No comments yet.

Reviews (0)

No reviews yet.