TimeAgo.Net 1.0.0

TimeAgo.Net

Convert DateTime into human-readable strings like "5 minutes ago" or "in 2 days" with multilingual support.

Features

• Supports past & future tense (e.g., "5 minutes ago", "in 3 hours")
• Built-in support for English, Spanish, and Bengali
• Easily extendable to more languages
• Lightweight & dependency-free
• Works in .NET 6+ / .NET 8 projects

Installation

dotnet add package TimeAgo.Net

Usage Example

using System;
using TimeAgo.Net.Extensions;

class Program
{
    static void Main()
    {
        // Ensure Bengali displays correctly
        Console.OutputEncoding = System.Text.Encoding.UTF8;

        // English examples
        Console.WriteLine(DateTime.Now.AddMinutes(-5).ToTimeAgo("en"));  // "5 minutes ago"
        Console.WriteLine(DateTime.Now.AddMinutes(10).ToTimeAgo("en"));  // "in 10 minutes"

        // Spanish examples
        Console.WriteLine(DateTime.Now.AddHours(-2).ToTimeAgo("es"));    // "hace 2 horas"
        Console.WriteLine(DateTime.Now.AddHours(3).ToTimeAgo("es"));     // "en 3 horas"

        // Bengali examples
        Console.WriteLine(DateTime.Now.AddDays(-1).ToTimeAgo("bn"));     // "১ দিন আগে"
        Console.WriteLine(DateTime.Now.AddDays(3).ToTimeAgo("bn"));      // "3 দিন পরে"
    }
}

Extending to Other Languages

You can add additional languages by providing your own dictionary when creating the TimeAgoService:

var customResources = new Dictionary<string, Dictionary<string, string>>
{
    ["fr"] = new Dictionary<string, string>
    {
        {"Seconds_Singular_Past", "il y a 1 seconde"},
        {"Seconds_Plural_Past", "il y a {0} secondes"},
        {"Minutes_Singular_Past", "il y a 1 minute"},
        {"Minutes_Plural_Past", "il y a {0} minutes"},
        {"Seconds_Singular_Future", "dans 1 seconde"},
        {"Seconds_Plural_Future", "dans {0} secondes"},
        {"Minutes_Singular_Future", "dans 1 minute"},
        {"Minutes_Plural_Future", "dans {0} minutes"},
        // Add remaining keys for Hours, Days, Months, Years
    }
};

var service = new TimeAgo.Net.Services.TimeAgoService(customResources);
Console.WriteLine(service.Format(DateTime.Now.AddMinutes(-5), "fr")); // "il y a 5 minutes"

License

This project is licensed under the MIT License.

Project URL

https://github.com/shahedbd/TimeAgo.Net