Getting Started

This guide will help you quickly get up and running with Wolfgang.Extensions.DateTime.

Prerequisites

  • .NET 8.0 SDK or later (for development; the library targets .NET Framework 4.6.2+, .NET Standard 2.0, and .NET 8.0+)

Installation

Via NuGet Package Manager

dotnet add package Wolfgang.Extensions.DateTime

Via Package Manager Console

Install-Package Wolfgang.Extensions.DateTime

Quick Start

using Wolfgang.Extensions.DateTime;

var now = System.DateTime.Now;

// Truncate to remove sub-second or sub-minute precision
var noMilliseconds = now.TruncateMilliseconds();  // Zeroes out milliseconds
var noSeconds = now.TruncateSeconds();              // Zeroes out seconds and milliseconds

// Navigate to month boundaries
var firstOfMonth = now.FirstOfMonth();  // e.g. 2026-03-01 00:00:00.000
var endOfMonth = now.EndOfMonth();      // e.g. 2026-03-31 23:59:59.9999999

// Navigate to year boundaries
var firstOfYear = now.FirstOfYear();    // e.g. 2026-01-01 00:00:00.000
var endOfYear = now.EndOfYear();        // e.g. 2026-12-31 23:59:59.9999999

// Navigate to week boundaries (culture-aware)
var firstOfWeek = now.FirstOfWeek();                        // Uses CurrentCulture
var firstOfWeekMon = now.FirstOfWeek(DayOfWeek.Monday);     // Explicit start day
var endOfWeek = now.EndOfWeek();

Next Steps

Common Issues

Namespace conflicts with System.DateTime

The library namespace is Wolfgang.Extensions.DateTime, which can conflict with System.DateTime. In the source code, the type is referenced as System.DateTime to avoid ambiguity. If you encounter conflicts, use a fully qualified name or a using alias.

DateTimeKind is preserved

All extension methods preserve the DateTimeKind of the input. If you pass a UTC DateTime, you get a UTC DateTime back.

Additional Resources

Edit this page