Soenneker.Extensions.TimeSpan 4.0.1795

Prefix Reserved

dotnet add package Soenneker.Extensions.TimeSpan --version 4.0.1795

NuGet\Install-Package Soenneker.Extensions.TimeSpan -Version 4.0.1795

This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.

<PackageReference Include="Soenneker.Extensions.TimeSpan" Version="4.0.1795" />

For projects that support PackageReference, copy this XML node into the project file to reference the package.

<PackageVersion Include="Soenneker.Extensions.TimeSpan" Version="4.0.1795" />
                    

                            Directory.Packages.props

<PackageReference Include="Soenneker.Extensions.TimeSpan" />
                    

                            Project file

For projects that support Central Package Management (CPM), copy this XML node into the solution Directory.Packages.props file to version the package.

paket add Soenneker.Extensions.TimeSpan --version 4.0.1795

The NuGet Team does not provide support for this client. Please contact its maintainers for support.

#r "nuget: Soenneker.Extensions.TimeSpan, 4.0.1795"

#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.

#:package Soenneker.Extensions.TimeSpan@4.0.1795

#:package directive can be used in C# file-based apps starting in .NET 10 preview 4. Copy this into a .cs file before any lines of code to reference the package.

#addin nuget:?package=Soenneker.Extensions.TimeSpan&version=4.0.1795
                    

                            Install as a Cake Addin

#tool nuget:?package=Soenneker.Extensions.TimeSpan&version=4.0.1795
                    

                            Install as a Cake Tool

The NuGet Team does not provide support for this client. Please contact its maintainers for support.

Soenneker.Extensions.TimeSpan

Format durations and convert clock-time TimeSpan values across time zones.

Installation

dotnet add package Soenneker.Extensions.TimeSpan

Format a duration

using Soenneker.Extensions.TimeSpan;

TimeSpan elapsed = TimeSpan.FromMinutes(65);

string compact = elapsed.ToDisplayFormat();       // "1h 5m"
string readable = elapsed.ToDisplayFormat(false); // "1 hour, 5 minutes"

ToDisplayFormat() chooses the two most significant units and treats a year as 365 days. Durations below one millisecond, including negative values, return "0s".

For fixed component formats, ToHourMinuteSecondString() uses hh:mm:ss and wraps hours after 23; ToMinuteSecondString() uses mm:ss and wraps minutes after 59. These are component displays, not total-hour or total-minute formats.

Work with times of day

TimeSpan localClock = new(9, 30, 0);
DateTime utcInstant = DateTime.UtcNow;

TimeSpan utcClock = localClock.ToUtcFromTz(utcInstant, timeZone);
TimeSpan roundTrip = utcClock.ToTzFromUtc(utcInstant, timeZone);

The conversion helpers interpret the TimeSpan as a clock time, apply the zone offset at the supplied instant (including daylight-saving and fractional-hour offsets), and normalize the result into [00:00:00, 24:00:00). Pass a UTC DateTime/DateTimeOffset that represents the date whose offset you need; a time zone cannot be converted correctly without a date.

ToShortTime() also treats the value as a clock time, normalizes it to one day, and emits an invariant 12-hour value such as "9:30 AM".

Test a clock range

bool open = new TimeSpan(23, 0, 0).IsBetween(
    start: new TimeSpan(22, 0, 0),
    end: new TimeSpan(2, 0, 0)); // true

IsBetween() is start-inclusive and end-exclusive and supports ranges that cross midnight. Equal start and end values represent an empty range, not a full day.

Product	Compatible and additional computed target framework versions.
.NET	net10.0 is compatible. net10.0-android was computed. net10.0-browser was computed. net10.0-ios was computed. net10.0-maccatalyst was computed. net10.0-macos was computed. net10.0-tvos was computed. net10.0-windows was computed.

Compatible target framework(s)

Included target framework(s) (in package)

Learn more about Target Frameworks and .NET Standard.

net10.0
- Soenneker.Extensions.DateTime (>= 4.0.1788)
- Soenneker.Extensions.DateTimeOffsets (>= 4.0.143)

NuGet packages

This package is not used by any NuGet packages.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version	Downloads	Last Updated
4.0.1795	78	9/1/2026
4.0.1794	67	9/1/2026
4.0.1793	76	8/31/2026
4.0.1792	73	8/31/2026
4.0.1791	78	8/31/2026
4.0.1790	82	8/31/2026
4.0.1789	76	8/30/2026
4.0.1788	76	8/30/2026
4.0.1787	78	8/30/2026
4.0.1786	77	8/30/2026
4.0.1785	83	8/30/2026
4.0.1784	75	8/30/2026
4.0.1783	75	8/30/2026
4.0.1782	74	8/30/2026
4.0.1781	79	8/29/2026
4.0.1780	74	8/29/2026
4.0.1779	77	8/29/2026
4.0.1778	83	8/26/2026
4.0.1777	82	8/26/2026
4.0.1776	89	8/25/2026

Updated NuGet packages