Noda Time , a better date and time API

What is Noda Time

Noda Time is a Nuget Package / Library developed by Jon Skeet with 96M downloads (until today), it is an alternative for dealing with date and time. If you are familiar with Java world then Noda Time is C# version of Joda Time

Why we should use it over default Date Time

1. Lack of clarity in DateTime especially when comparing local and UTC times

2. DateTimeKind property and various operations like ToUniversalTime() and ToLocalTime() can lead to unexpected results

3. DateTime does not provide a comprehensive solution for handling time zones.

4. TimeZoneInfo, used in .NET, relies on Windows time zone IDs, which may differ from widely used Olson (tz) identifiers

5. Unfortunately humanity did’ not agree on single calendar (Gregorian, Julian, Coptic and Buddhist) , NodaTime covers this space which default lacks.

6. Instead of maintaining offset in default Noda gives you facility of using ZonedDateTime

7. I love their documentation , I have not seen such an amazing documentation yet. They really care and understand the needs of users

If I could not satisfy you then Mr. Jon Skeet will hopefully, Read this blog of Jon Skeet for in depth

How to use it in .NET

It is quite simple , you just need to install these Nuget packages

• NodaTime
• NodaTime.Testing
• NodaTime.Serialization.JsonNet

These are few types available in .NET with NodaTime :

1. LocalDate -including day,month,year , calendar
2. DateTimeZone - To shift in a specific time zone , pass it Iana
3. ZonedClock - A clock associated with time zone
4. Period - To clculate time difference in calendrical terms
5. Duration - Fixed length of elapsed time (irrespective of calendar)
6. Instant - A instant on global timeline with nanosecond resolution

Instant now = SystemClock.Instance.GetCurrentInstant());
ZonedDateTime nowInIsoUtc = now. InUtc();
Duration duration = Duration.FromMinutes(3);
ZonedDateTime thenInIsoUtc = nowInIsoUtc + duration;
var london = DateTimeZoneProviders.Tzdb ["Europe/London"];
var localDate = new LocalDateTime(2012, 3, 27, 0, 45,00);
var before = london. AtStrictly(localDate);

It is difficult to include all of them in this post , better visit documentation of NodaTime

Jon was born on June 19th, 1976 (Gregorian). How old is he now, in the UK time zone?

LocalDate birthDate = new LocalDate (1976, 6, 19);
DateTimeZone zone = DateTimeZoneProviders.Tzdb["Europe/London"];
ZonedClock clock = SystemClock.Instance.InZone(zone);
LocalDate today clock.GetCurrentDate();
Console.WriteLine($"Today's date: {today: yyyy-MM-dd}");
Period age = Period.Between (birthDate, today);
Cosole.WriteLine($"Jon is: {age. Years} years old.");

The more you explore it more interesting things you will find.