feat(utility): 添加包含时区偏移的 Unix 时间戳方法

添加 UnixTimeSecondsWithTimeZone 和 UnixTimeMillisecondsWithTimeZone 方法，用于获取包含当前设置时区偏移量的 Unix 时间戳。这为需要基于本地时区计算时间戳的场景提供了便利。

同时添加了相应的单元测试，验证时区偏移量被正确包含在时间戳计算中。

Author: AlianBlank

GameFrameX.Foundation.Tests/Utility/TimerHelperTimeZoneTests.cs

@@ -196,5 +196,32 @@ public void SetTimeZone_WithInvalidId_ShouldDefaultToUtc()
             TimerHelper.SetTimeZone("InvalidTimeZoneId");
             Assert.Equal(TimeZoneInfo.Utc.Id, TimerHelper.CurrentTimeZone.Id);
         }
+
+        /// <summary>
+        /// 测试 UnixTimeSecondsWithTimeZone 和 UnixTimeMillisecondsWithTimeZone 应包含时区偏移
+        /// </summary>
+        [Fact]
+        public void UnixTimeWithTimeZone_ShouldIncludeOffset()
+        {
+            var offset = TimeSpan.FromHours(8);
+            var customTimeZone = TimeZoneInfo.CreateCustomTimeZone("Test+8", offset, "Test+8", "Test+8");
+            TimerHelper.SetTimeZone(customTimeZone);
+
+            var tsStandard = TimerHelper.UnixTimeSeconds();
+            var tsWithZone = TimerHelper.UnixTimeSecondsWithTimeZone();
+            var tsMsStandard = TimerHelper.UnixTimeMilliseconds();
+            var tsMsWithZone = TimerHelper.UnixTimeMillisecondsWithTimeZone();
+
+            // 验证秒级时间戳差异接近 8 小时 (28800 秒)
+            // 注意：由于执行时间差异，tsStandard 和 tsWithZone 获取的时间点可能略有不同，但差异不应很大
+            var diffSeconds = tsWithZone - tsStandard;
+            // 允许误差在 2 秒内
+            Assert.True(Math.Abs(diffSeconds - 28800) <= 2, $"Expected diff 28800, but got {diffSeconds}");
+
+            // 验证毫秒级时间戳差异接近 8 小时 (28800000 毫秒)
+            var diffMilliseconds = tsMsWithZone - tsMsStandard;
+            // 允许误差在 100 毫秒内
+            Assert.True(Math.Abs(diffMilliseconds - 28800000) <= 100, $"Expected diff 28800000, but got {diffMilliseconds}");
+        }
     }
 }

GameFrameX.Foundation.Utility/Time/TimerHelper.cs

@@ -143,6 +143,42 @@ public static long UnixTimeMilliseconds()
         return new DateTimeOffset(GetUtcNow()).ToUnixTimeMilliseconds();
     }
 
+    /// <summary>
+    /// 获取基于当前设置时区的 Unix 时间戳（秒级精度）。
+    /// </summary>
+    /// <returns>
+    /// 返回一个 <see cref="long"/> 值，表示将当前设置时区的时间视为 UTC 时间时的 Unix 时间戳。
+    /// 即：标准 Unix 时间戳 + 时区偏移秒数。
+    /// </returns>
+    /// <remarks>
+    /// 此方法返回的时间戳包含时区偏移量。
+    /// 例如：如果当前时区为 UTC+8，则返回的时间戳比标准 UTC 时间戳大 8 小时（28800秒）。
+    /// </remarks>
+    public static long UnixTimeSecondsWithTimeZone()
+    {
+        var utcNow = GetUtcNow();
+        var offset = CurrentTimeZone.GetUtcOffset(utcNow);
+        return new DateTimeOffset(utcNow).ToUnixTimeSeconds() + (long)offset.TotalSeconds;
+    }
+
+    /// <summary>
+    /// 获取基于当前设置时区的 Unix 时间戳（毫秒级精度）。
+    /// </summary>
+    /// <returns>
+    /// 返回一个 <see cref="long"/> 值，表示将当前设置时区的时间视为 UTC 时间时的 Unix 时间戳。
+    /// 即：标准 Unix 时间戳 + 时区偏移毫秒数。
+    /// </returns>
+    /// <remarks>
+    /// 此方法返回的时间戳包含时区偏移量。
+    /// 例如：如果当前时区为 UTC+8，则返回的时间戳比标准 UTC 时间戳大 8 小时（28800000毫秒）。
+    /// </remarks>
+    public static long UnixTimeMillisecondsWithTimeZone()
+    {
+        var utcNow = GetUtcNow();
+        var offset = CurrentTimeZone.GetUtcOffset(utcNow);
+        return new DateTimeOffset(utcNow).ToUnixTimeMilliseconds() + (long)offset.TotalMilliseconds;
+    }
+
     /// <summary>
     /// 获取指定时间距离纪元时间的毫秒数。
     /// </summary>