< Summary

Information
Class: MyNet.Temporal.Intervals.DateTimeOffsetPeriod
Assembly: MyNet.Temporal
File(s): https://raw.githubusercontent.com/sandre58/MyNet/5aaaab311aa14541478b9e402357d98b657a23e4/src/MyNet.Temporal/Intervals/DateTimeOffsetPeriod.cs
Tag: 342_31701152804
Line coverage
100%
Covered lines: 13
Uncovered lines: 0
Coverable lines: 13
Total lines: 61
Line coverage: 100%
Branch coverage
50%
Covered branches: 4
Total branches: 8
Branch coverage: 50%
Method coverage

Feature is only available for sponsors

Upgrade to PRO version

Metrics

MethodBranch coverage Crap Score Cyclomatic complexity Line coverage
.ctor(...)100%11100%
FromDuration(...)100%11100%
Shift(...)100%11100%
Extend(...)100%11100%
ToDateTimePeriod()100%11100%
ToUtcDateTimePeriod()100%11100%
Create(...)50%88100%

File(s)

https://raw.githubusercontent.com/sandre58/MyNet/5aaaab311aa14541478b9e402357d98b657a23e4/src/MyNet.Temporal/Intervals/DateTimeOffsetPeriod.cs

#LineLine coverage
 1// -----------------------------------------------------------------------
 2// <copyright file="DateTimeOffsetPeriod.cs" company="Stéphane ANDRE">
 3// Copyright (c) Stéphane ANDRE. All rights reserved.
 4// </copyright>
 5// -----------------------------------------------------------------------
 6
 7using System;
 8
 9using MyNet.Primitives.Intervals;
 10
 11namespace MyNet.Temporal.Intervals;
 12
 13/// <summary>
 14/// Half-open absolute <see cref="DateTimeOffset"/> interval <c>[start, end)</c>: start inclusive, end exclusive.
 15/// Prefer this type for API / domain occupation spans across offsets. For civil UI time, use
 16/// <see cref="DateTimePeriod"/> instead.
 17/// </summary>
 18/// <param name="start">Inclusive start.</param>
 19/// <param name="end">Exclusive end.</param>
 20public sealed class DateTimeOffsetPeriod(DateTimeOffset start, DateTimeOffset end)
 3621    : DateTimeOffsetInterval<DateTimeOffsetPeriod>(start, end, inclusiveStart: true, inclusiveEnd: false)
 22{
 23    /// <summary>
 24    /// Creates a period from a start and a fixed <see cref="TimeSpan"/> duration.
 25    /// </summary>
 326    public static DateTimeOffsetPeriod FromDuration(DateTimeOffset start, TimeSpan duration) => new(start, start + durat
 27
 28    /// <summary>
 29    /// Returns a new DateTimeOffsetPeriod shifted by <paramref name="offset"/>.
 30    /// </summary>
 331    public DateTimeOffsetPeriod Shift(TimeSpan offset) => new(Start!.Value.Value + offset, End!.Value.Value + offset);
 32
 33    /// <summary>
 34    /// Returns a new DateTimeOffsetPeriod with the end extended by <paramref name="offset"/>.
 35    /// </summary>
 336    public DateTimeOffsetPeriod Extend(TimeSpan offset) => new(Start!.Value.Value, End!.Value.Value + offset);
 37
 38    /// <summary>
 39    /// Preserves wall-clock components as <see cref="DateTimeKind.Unspecified"/> (civil / UI).
 40    /// Use <see cref="ToUtcDateTimePeriod"/> when you need absolute UTC clock faces.
 41    /// </summary>
 42    public DateTimePeriod ToDateTimePeriod() =>
 343        new(
 344            DateTime.SpecifyKind(Start!.Value.Value.DateTime, DateTimeKind.Unspecified),
 345            DateTime.SpecifyKind(End!.Value.Value.DateTime, DateTimeKind.Unspecified));
 46
 47    /// <summary>
 48    /// Converts bounds via <see cref="DateTimeOffset.UtcDateTime"/> (<see cref="DateTimeKind.Utc"/>).
 49    /// </summary>
 50    public DateTimePeriod ToUtcDateTimePeriod() =>
 351        new(Start!.Value.Value.UtcDateTime, End!.Value.Value.UtcDateTime);
 52
 53    /// <inheritdoc />
 54    protected override DateTimeOffsetPeriod Create(IntervalBoundary<DateTimeOffset>? start, IntervalBoundary<DateTimeOff
 355        !start.HasValue || !end.HasValue
 356            ? throw new InvalidOperationException("DateTimeOffsetPeriod must be bounded.")
 357            : !start.Value.IsInclusive || end.Value.IsInclusive
 358                ? throw new InvalidOperationException("DateTimeOffsetPeriod only supports [start, end) boundaries.")
 359                : new DateTimeOffsetPeriod(start.Value.Value, end.Value.Value);
 60}
 61