RegionTime 1.0.0

RegionTime

[![NuGet](https://img.shields.io/nuget/v/RegionTime.svg)](https://www.nuget.org/packages/RegionTime/)

Lightweight .NET library for **region-specific time conversion**, supporting both **Windows** and **IANA** timezone identifiers.

Cross-platform • DI-ready • Fast & Safe • No source code exposed

---

## Quick Start

### Install via NuGet
```bash
dotnet add package RegionTime --version 1.0.0

Direct Usage

using RegionTime.Services;

var timeService = new RegionTimeService();

Console.WriteLine(timeService.Now("Asia/Karachi"));
Console.WriteLine(timeService.FromUtc(DateTime.UtcNow, "America/New_York"));
Console.WriteLine(timeService.IsDaylightSavingTime(DateTime.UtcNow, "Europe/London"));

Using Dependency Injection (ASP.NET Core, etc.)

using Microsoft.Extensions.DependencyInjection;
using RegionTime.Extensions;

var services = new ServiceCollection();
services.AddRegionTime();

var provider = services.BuildServiceProvider();
var timeService = provider.GetRequiredService<IRegionTimeService>();

Console.WriteLine(timeService.Now("America/Los_Angeles"));

Features

• Now(string timeZone) – Get current time in any timezone
• FromUtc(DateTime utc, string timeZone) – Convert UTC → local
• IsDaylightSavingTime(DateTime dateTime, string timeZone) – DST check
• ConvertByOffset(DateTime dateTime, double offsetHours) – Simple offset conversion
• GetAllTimeZones() – List all available system timezones
• Full support for both IANA (Asia/Tokyo) and Windows (Pacific Standard Time) IDs
• Cross-platform (Windows, Linux, macOS)
• Built-in caching → blazing fast after first use
• Safe fallback + clear exceptions on invalid timezone IDs
• Dependency Injection ready

Exception Handling

try
{
    var dt = timeService.Now("Invalid/Zone");
}
catch (ArgumentException ex)
{
    Console.WriteLine(ex.Message);
    // Output: The timezone ID 'Invalid/Zone' is invalid or not recognized...
}

Public API Reference

IRegionTimeService

Dependency Injection

public static IServiceCollection AddRegionTime(this IServiceCollection services)

Registers IRegionTimeService as a singleton.

Performance

Benchmarked with BenchmarkDotNet – extremely fast thanks to internal timezone caching.

Notes

• Powered by TimeZoneConverter for perfect IANA ↔ Windows mapping

License

MIT License – free for personal and commercial use.

Enjoy accurate, hassle-free timezone handling!