RelativeTimeFormatter 1.0.1
dotnet add package RelativeTimeFormatter --version 1.0.1
NuGet\Install-Package RelativeTimeFormatter -Version 1.0.1
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="RelativeTimeFormatter" Version="1.0.1" />
For projects that support PackageReference, copy this XML node into the project file to reference the package.
<PackageVersion Include="RelativeTimeFormatter" Version="1.0.1" />
<PackageReference Include="RelativeTimeFormatter" />
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 RelativeTimeFormatter --version 1.0.1
The NuGet Team does not provide support for this client. Please contact its maintainers for support.
#r "nuget: RelativeTimeFormatter, 1.0.1"
#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.
#addin nuget:?package=RelativeTimeFormatter&version=1.0.1
#tool nuget:?package=RelativeTimeFormatter&version=1.0.1
The NuGet Team does not provide support for this client. Please contact its maintainers for support.
RelativeTimeFormatter
RelativeTimeFormatter is a lightweight C# library that turns TimeSpan and DateTime differences into natural, human-friendly text.
It's ideal for logs, notifications, and UIs that need readable time expressions like:
"just now", "3 minutes ago", "in 2 hours", "7 days from now"
β¨ Features
- Format
TimeSpanorDateTimedifferences into natural language - Built-in support for English and Spanish
- Pluggable localization (implement
ITimeLocalization) - Extension methods for clean syntax
- Easy to integrate into any .NET 8.0+ app
π Installation
dotnet add package RelativeTimeFormatter
π Usage
Format DateTime Differences
using RelativeTimeFormatter;
var now = DateTime.UtcNow;
var fiveMinutesAgo = now.AddMinutes(-5);
var inTwoHours = now.AddHours(2);
Console.WriteLine(Formatter.Format(fiveMinutesAgo)); // "5 minutes ago"
Console.WriteLine(Formatter.Format(inTwoHours)); // "in 2 hours"
Format TimeSpan Directly
var span = TimeSpan.FromSeconds(45);
Console.WriteLine(Formatter.Format(span)); // "45 seconds from now"
With Extension Methods
using RelativeTimeFormatter.Extensions;
TimeSpan delay = TimeSpan.FromMinutes(-10);
Console.WriteLine(delay.ToRelativeString()); // "10 minutes ago"
DateTime scheduled = DateTime.UtcNow.AddDays(3);
Console.WriteLine(scheduled.ToRelativeString()); // "in 3 days"
Change Localization
using RelativeTimeFormatter;
using RelativeTimeFormatter.Localizations;
Formatter.Localization = new SpanishTimeLocalization();
Console.WriteLine(DateTime.UtcNow.AddHours(-2).ToRelativeString()); // "hace 2 horas"
π License
MIT β do whatever you want, just donβt blame us if your logs become too human.
| Product | Versions Compatible and additional computed target framework versions. |
|---|---|
| .NET | net8.0 is compatible. net8.0-android was computed. net8.0-browser was computed. net8.0-ios was computed. net8.0-maccatalyst was computed. net8.0-macos was computed. net8.0-tvos was computed. net8.0-windows was computed. net9.0 was computed. net9.0-android was computed. net9.0-browser was computed. net9.0-ios was computed. net9.0-maccatalyst was computed. net9.0-macos was computed. net9.0-tvos was computed. net9.0-windows was computed. net10.0 was computed. 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.
-
net8.0
- No dependencies.
NuGet packages
This package is not used by any NuGet packages.
GitHub repositories
This package is not used by any popular GitHub repositories.