Add FromUnixTime(Milli)Seconds for unsigned types

X10D.Tests/src/Time/UInt16Tests.cs

@@ -7,6 +7,18 @@ namespace X10D.Tests.Time;
 [CLSCompliant(false)]
 public class UInt16Tests
 {
+    [TestMethod]
+    public void FromUnixTimeMilliseconds_ShouldBeEpoch_GivenZero()
+    {
+        Assert.AreEqual(new DateTime(1970, 1, 1, 0, 0, 0, DateTimeKind.Utc), ((ushort)0).FromUnixTimeMilliseconds());
+    }
+
+    [TestMethod]
+    public void FromUnixTimeSeconds_ShouldBeEpoch_GivenZero()
+    {
+        Assert.AreEqual(new DateTime(1970, 1, 1, 0, 0, 0, DateTimeKind.Utc), ((ushort)0).FromUnixTimeSeconds());
+    }
+
     [TestMethod]
     public void IsLeapYear_ShouldBeFalse_GivenMultipleOf100()
     {

X10D.Tests/src/Time/UInt32Tests.cs

@@ -7,6 +7,18 @@ namespace X10D.Tests.Time;
 [CLSCompliant(false)]
 public class UInt32Tests
 {
+    [TestMethod]
+    public void FromUnixTimeMilliseconds_ShouldBeEpoch_GivenZero()
+    {
+        Assert.AreEqual(new DateTime(1970, 1, 1, 0, 0, 0, DateTimeKind.Utc), 0U.FromUnixTimeMilliseconds());
+    }
+
+    [TestMethod]
+    public void FromUnixTimeSeconds_ShouldBeEpoch_GivenZero()
+    {
+        Assert.AreEqual(new DateTime(1970, 1, 1, 0, 0, 0, DateTimeKind.Utc), 0U.FromUnixTimeSeconds());
+    }
+
     [TestMethod]
     public void IsLeapYear_ShouldBeFalse_GivenMultipleOf100()
     {

X10D.Tests/src/Time/UInt64Tests.cs

@@ -7,6 +7,18 @@ namespace X10D.Tests.Time;
 [CLSCompliant(false)]
 public class UInt64Tests
 {
+    [TestMethod]
+    public void FromUnixTimeMilliseconds_ShouldBeEpoch_GivenZero()
+    {
+        Assert.AreEqual(new DateTime(1970, 1, 1, 0, 0, 0, DateTimeKind.Utc), 0UL.FromUnixTimeMilliseconds());
+    }
+
+    [TestMethod]
+    public void FromUnixTimeSeconds_ShouldBeEpoch_GivenZero()
+    {
+        Assert.AreEqual(new DateTime(1970, 1, 1, 0, 0, 0, DateTimeKind.Utc), 0UL.FromUnixTimeSeconds());
+    }
+
     [TestMethod]
     public void IsLeapYear_ShouldBeFalse_GivenMultipleOf100()
     {

X10D/src/Time/UInt16Extensions.cs

@@ -9,6 +9,48 @@ namespace X10D.Time;
 [CLSCompliant(false)]
 public static class UInt16Extensions
 {
+    /// <summary>
+    ///     Converts a Unix time expressed as the number of milliseconds that have elapsed since 1970-01-01T00:00:00Z to a
+    ///     <see cref="DateTimeOffset" /> value.
+    /// </summary>
+    /// <param name="value">
+    ///     A Unix time, expressed as the number of milliseconds that have elapsed since 1970-01-01T00:00:00Z (January 1,
+    ///     1970, at 12:00 AM UTC). For Unix times before this date, its value is negative.
+    /// </param>
+    /// <returns>A date and time value that represents the same moment in time as the Unix time.</returns>
+    /// <exception cref="ArgumentOutOfRangeException">
+    ///     <para><paramref name="value" /> is less than -62,135,596,800,000.</para>
+    ///     -or-
+    ///     <para><paramref name="value" /> is greater than 253,402,300,799,999.</para>
+    /// </exception>
+    [Pure]
+    [MethodImpl(MethodImplOptions.AggressiveInlining | MethodImplOptions.AggressiveOptimization)]
+    public static DateTimeOffset FromUnixTimeMilliseconds(this ushort value)
+    {
+        return DateTimeOffset.FromUnixTimeMilliseconds(value);
+    }
+
+    /// <summary>
+    ///     Converts a Unix time expressed as the number of seconds that have elapsed since 1970-01-01T00:00:00Z to a
+    ///     <see cref="DateTimeOffset" /> value.
+    /// </summary>
+    /// <param name="value">
+    ///     A Unix time, expressed as the number of seconds that have elapsed since 1970-01-01T00:00:00Z (January 1, 1970, at
+    ///     12:00 AM UTC). For Unix times before this date, its value is negative.
+    /// </param>
+    /// <returns>A date and time value that represents the same moment in time as the Unix time.</returns>
+    /// <exception cref="ArgumentOutOfRangeException">
+    ///     <para><paramref name="value" /> is less than -62,135,596,800.</para>
+    ///     -or-
+    ///     <para><paramref name="value" /> is greater than 253,402,300,799.</para>
+    /// </exception>
+    [Pure]
+    [MethodImpl(MethodImplOptions.AggressiveInlining | MethodImplOptions.AggressiveOptimization)]
+    public static DateTimeOffset FromUnixTimeSeconds(this ushort value)
+    {
+        return DateTimeOffset.FromUnixTimeSeconds(value);
+    }
+
     /// <summary>
     ///     Returns a value indicating whether the current integer, representing a year, is a leap year.
     /// </summary>

X10D/src/Time/UInt32Extensions.cs

@@ -9,6 +9,48 @@ namespace X10D.Time;
 [CLSCompliant(false)]
 public static class UInt32Extensions
 {
+    /// <summary>
+    ///     Converts a Unix time expressed as the number of milliseconds that have elapsed since 1970-01-01T00:00:00Z to a
+    ///     <see cref="DateTimeOffset" /> value.
+    /// </summary>
+    /// <param name="value">
+    ///     A Unix time, expressed as the number of milliseconds that have elapsed since 1970-01-01T00:00:00Z (January 1,
+    ///     1970, at 12:00 AM UTC). For Unix times before this date, its value is negative.
+    /// </param>
+    /// <returns>A date and time value that represents the same moment in time as the Unix time.</returns>
+    /// <exception cref="ArgumentOutOfRangeException">
+    ///     <para><paramref name="value" /> is less than -62,135,596,800,000.</para>
+    ///     -or-
+    ///     <para><paramref name="value" /> is greater than 253,402,300,799,999.</para>
+    /// </exception>
+    [Pure]
+    [MethodImpl(MethodImplOptions.AggressiveInlining | MethodImplOptions.AggressiveOptimization)]
+    public static DateTimeOffset FromUnixTimeMilliseconds(this uint value)
+    {
+        return DateTimeOffset.FromUnixTimeMilliseconds(value);
+    }
+
+    /// <summary>
+    ///     Converts a Unix time expressed as the number of seconds that have elapsed since 1970-01-01T00:00:00Z to a
+    ///     <see cref="DateTimeOffset" /> value.
+    /// </summary>
+    /// <param name="value">
+    ///     A Unix time, expressed as the number of seconds that have elapsed since 1970-01-01T00:00:00Z (January 1, 1970, at
+    ///     12:00 AM UTC). For Unix times before this date, its value is negative.
+    /// </param>
+    /// <returns>A date and time value that represents the same moment in time as the Unix time.</returns>
+    /// <exception cref="ArgumentOutOfRangeException">
+    ///     <para><paramref name="value" /> is less than -62,135,596,800.</para>
+    ///     -or-
+    ///     <para><paramref name="value" /> is greater than 253,402,300,799.</para>
+    /// </exception>
+    [Pure]
+    [MethodImpl(MethodImplOptions.AggressiveInlining | MethodImplOptions.AggressiveOptimization)]
+    public static DateTimeOffset FromUnixTimeSeconds(this uint value)
+    {
+        return DateTimeOffset.FromUnixTimeSeconds(value);
+    }
+
     /// <summary>
     ///     Returns a value indicating whether the current integer, representing a year, is a leap year.
     /// </summary>

X10D/src/Time/UInt64Extensions.cs

@@ -9,6 +9,48 @@ namespace X10D.Time;
 [CLSCompliant(false)]
 public static class UInt64Extensions
 {
+    /// <summary>
+    ///     Converts a Unix time expressed as the number of milliseconds that have elapsed since 1970-01-01T00:00:00Z to a
+    ///     <see cref="DateTimeOffset" /> value.
+    /// </summary>
+    /// <param name="value">
+    ///     A Unix time, expressed as the number of milliseconds that have elapsed since 1970-01-01T00:00:00Z (January 1,
+    ///     1970, at 12:00 AM UTC). For Unix times before this date, its value is negative.
+    /// </param>
+    /// <returns>A date and time value that represents the same moment in time as the Unix time.</returns>
+    /// <exception cref="ArgumentOutOfRangeException">
+    ///     <para><paramref name="value" /> is less than -62,135,596,800,000.</para>
+    ///     -or-
+    ///     <para><paramref name="value" /> is greater than 253,402,300,799,999.</para>
+    /// </exception>
+    [Pure]
+    [MethodImpl(MethodImplOptions.AggressiveInlining | MethodImplOptions.AggressiveOptimization)]
+    public static DateTimeOffset FromUnixTimeMilliseconds(this ulong value)
+    {
+        return DateTimeOffset.FromUnixTimeMilliseconds((long)value);
+    }
+
+    /// <summary>
+    ///     Converts a Unix time expressed as the number of seconds that have elapsed since 1970-01-01T00:00:00Z to a
+    ///     <see cref="DateTimeOffset" /> value.
+    /// </summary>
+    /// <param name="value">
+    ///     A Unix time, expressed as the number of seconds that have elapsed since 1970-01-01T00:00:00Z (January 1, 1970, at
+    ///     12:00 AM UTC). For Unix times before this date, its value is negative.
+    /// </param>
+    /// <returns>A date and time value that represents the same moment in time as the Unix time.</returns>
+    /// <exception cref="ArgumentOutOfRangeException">
+    ///     <para><paramref name="value" /> is less than -62,135,596,800.</para>
+    ///     -or-
+    ///     <para><paramref name="value" /> is greater than 253,402,300,799.</para>
+    /// </exception>
+    [Pure]
+    [MethodImpl(MethodImplOptions.AggressiveInlining | MethodImplOptions.AggressiveOptimization)]
+    public static DateTimeOffset FromUnixTimeSeconds(this ulong value)
+    {
+        return DateTimeOffset.FromUnixTimeSeconds((long)value);
+    }
+
     /// <summary>
     ///     Returns a value indicating whether the current integer, representing a year, is a leap year.
     /// </summary>