Table of Contents

Class DateTimeRange

Namespace
Cuemon
Assembly
Cuemon.Core.dll

Represents a period of time between two DateTime values.

public class DateTimeRange : Range<DateTime>, IEqualityComparer<Range<DateTime>>
Inheritance
DateTimeRange
Implements
Inherited Members

Examples

The following example demonstrates how to use DateTimeRange to represent and query a range between two DateTime values. It creates a range for January 2026, queries the start and end points, computes the duration, and tests equality against another range. Custom formatting and hash-code access are also shown. Each result is written to the console, confirming that date-range creation, comparison, and formatting behave as expected.

using System;
using Cuemon;

namespace MyApp.Time
{
    public class DateTimeRangeExample
    {
        public void Demonstrate()
        {
            // Create a date-time range representing January 2026
            var start = new DateTime(2026, 1, 1, 0, 0, 0, DateTimeKind.Utc);
            var end = new DateTime(2026, 1, 31, 23, 59, 59, DateTimeKind.Utc);
            var range = new DateTimeRange(start, end);

            // Access start and end points
            Console.WriteLine($"Start: {range.Start:O}");  // 2026-01-01T00:00:00.0000000Z
            Console.WriteLine($"End:   {range.End:O}");    // 2026-01-31T23:59:59.0000000Z

            // Duration between start and end
            Console.WriteLine($"Duration: {range.Duration.Days} days"); // 30 days
            Console.WriteLine($"Duration: {range.Duration}");          // 30.23:59:59

            // Default ToString() uses sortable format
            Console.WriteLine(range.ToString()); // "2026-01-01T00:00:00"

            // Custom format with invariant culture
            Console.WriteLine(range.ToString("d", null)); // "1/1/2026 ... 1/31/2026"

            // Equality comparison via the inherited IEqualityComparer<Range<DateTime>>
            var sameRange = new DateTimeRange(start, end);
            Console.WriteLine(range.Equals(range, sameRange)); // True

            var differentRange = new DateTimeRange(start, new DateTime(2026, 2, 1));
            Console.WriteLine(range.Equals(range, differentRange)); // False

            // Hash code based on start and end
            var hash = range.GetHashCode(range);
            Console.WriteLine($"Hash: {hash}");

            // Practical use: measure a business period
            var quarterStart = new DateTime(2026, 4, 1);
            var quarterEnd = new DateTime(2026, 6, 30);
            var q1 = new DateTimeRange(quarterStart, quarterEnd);
            Console.WriteLine($"Q2 2026 lasts {q1.Duration.TotalDays} days."); // 90 days

}}
}

Constructors

DateTimeRange(DateTime, DateTime)

Initializes a new instance of the DateTimeRange struct.

public DateTimeRange(DateTime start, DateTime end)

Parameters

start DateTime

The start date of a time range.

end DateTime

The end date of a time range.

Methods

ToString()

Returns a string that represents this instance.

public override string ToString()

Returns

string

A string that represents this instance.

Edit this page