Unfucked.DateTime

🧰 Unfucked.DateTime

Fix egregiously missing functionality in Noda Time. Inspired by Joda-Time.

• Installation
• Usage
• All Unfucked libraries

Installation

dotnet package add Unfucked.DateTime

using Unfucked;

Usage

• Absolute value of a Duration

  ZonedDateTime a, b;
  Duration abs = (a - b).Abs();
  

• Get midnight from a ZonedDateTime as a ZonedDateTime, Period, or Duration

  ZonedDateTime now = SystemClock.Instance.InTzdbSystemDefaultZone().GetCurrentZonedDateTime();
  ZonedDateTime midnight = now.StartOfDay;
  Duration sinceMidnight = now.LocalDateTime.TimeOfDay.DurationSinceStartOfDay;
  Period sinceMidnight2 = now.LocalDateTime.TimeOfDay.PeriodSinceStartOfDay;
  

• Convert time zone offset to hours

  double hours = DateTimeZoneProviders.Tzdb["America/Los_Angeles"].GetUtcOffset(SystemClock.Instance.GetCurrentInstant()).Hours;
  

• Compare two OffsetDateTimes to see which one happens first

  OffsetDateTime a, b;
  bool isBefore = a.IsBefore(b);
  isBefore = !b.IsAfter(a);
  

• More succinct and interchangeable way to define standard TimeSpan, Period, and Duration instances by force casting integral numbers to or constructing Milliseconds, Seconds, Minutes, Hours, and Days, all of which implicitly convert to TimeSpan, Period, and Duration

  TimeSpan t = (Milliseconds) 3;
  TimeSpan t = (Seconds) 1;
  TimeSpan t = (Minutes) 4;
  Period t   = (Hours) 1;
  Duration t = (Days) 5;
  

• Convenience accessors to make Noda Time's confusing API more discoverable and understandable. If you somehow really need an alternative instance of IClock to write unit tests, you can do this the original way.

  var clock = DateTimeZoneProviders.Tzdb["America/Los_Angeles"].Clock;
  
  var now = ZonedDateTime.Now;
  var now = ZonedDateTime.NowUtc;
  var now = OffsetDateTime.Now;
  var now = OffsetDateTime.NowUtc;
  var now = Instant.Now;
  var now = LocalDateTime.Now;
  var now = LocalTime.Now;
  var now = LocalDate.Now;
  

• Automatically periodically update the IANA time zone database (tzdb) that is included with Noda Time by fetching it from Noda Time's servers. This allows your program to get time zone updates without having to update a NuGet package, recompile, deploy a new version, or restart your process.

  IDateTimeZoneProvider tzdb = DateTimeZoneProviders.CreateOnlineUpdatingTzdbProvider(TimeSpan.FromDays(1));
  ZonedDateTime now = tzdb["America/Los_Angeles"].Clock.GetCurrentZonedDateTime();
  

All Unfucked libraries

• Unfucked
• Unfucked.Caching
• Unfucked.Compression
• Unfucked.DateTime
• Unfucked.DI
• Unfucked.HTTP
• Unfucked.ICS
• Unfucked.OBS
• Unfucked.PGP
• Unfucked.STUN
• Unfucked.Twitch
• Unfucked.Windows