Skip to content

Commit 73ef847

Browse files
committed
refactor(utility): 移除基于本地时区的时间戳方法
删除 NowTimeSeconds 和 NowTimeMilliseconds 方法,统一使用基于 UTC 的时间戳方法以保持一致性并避免时区相关问题。
1 parent 805bd9e commit 73ef847

1 file changed

Lines changed: 0 additions & 80 deletions

File tree

GameFrameX.Foundation.Utility/Time/TimerHelper.cs

Lines changed: 0 additions & 80 deletions
Original file line numberDiff line numberDiff line change
@@ -143,86 +143,6 @@ public static long UnixTimeMilliseconds()
143143
return new DateTimeOffset(GetUtcNow()).ToUnixTimeMilliseconds();
144144
}
145145

146-
/// <summary>
147-
/// 获取当前本地时区时间的 Unix 时间戳(秒级精度)。
148-
/// </summary>
149-
/// <returns>
150-
/// 返回一个 <see cref="long"/> 值,表示从 Unix 纪元(1970-01-01 00:00:00 UTC)到当前本地时间的秒数。
151-
/// </returns>
152-
/// <remarks>
153-
/// 此方法执行以下步骤:
154-
/// 1. 获取当前本地时区时间(<see cref="DateTime.Now"/>)
155-
/// 2. 创建 <see cref="DateTimeOffset"/> 对象以保留时区信息
156-
/// 3. 转换为 Unix 时间戳(秒级精度)
157-
///
158-
/// 与 <see cref="UnixTimeSeconds"/> 方法的区别:
159-
/// - 本方法基于本地时区时间计算
160-
/// - <see cref="UnixTimeSeconds"/> 基于 UTC 时间计算
161-
///
162-
/// 适用场景:需要考虑本地时区的时间戳生成,如用户界面显示、本地日志记录等。
163-
/// </remarks>
164-
/// <example>
165-
/// <code>
166-
/// // 获取当前本地时区的时间戳
167-
/// long localTimestamp = TimerHelper.NowTimeSeconds();
168-
/// Console.WriteLine($"本地时区时间戳(秒): {localTimestamp}");
169-
///
170-
/// // 与UTC时间戳对比
171-
/// long utcTimestamp = TimerHelper.UnixTimeSeconds();
172-
/// long timezoneOffset = localTimestamp - utcTimestamp;
173-
/// Console.WriteLine($"时区偏移(秒): {timezoneOffset}");
174-
/// </code>
175-
/// </example>
176-
/// <seealso cref="UnixTimeSeconds"/>
177-
/// <seealso cref="NowTimeMilliseconds"/>
178-
/// <seealso cref="EpochLocal"/>
179-
public static long NowTimeSeconds()
180-
{
181-
return new DateTimeOffset(GetNow()).ToUnixTimeSeconds();
182-
}
183-
184-
/// <summary>
185-
/// 获取当前本地时区时间的 Unix 时间戳(毫秒级精度)。
186-
/// </summary>
187-
/// <returns>
188-
/// 返回一个 <see cref="long"/> 值,表示从 Unix 纪元(1970-01-01 00:00:00 UTC)到当前本地时间的毫秒数。
189-
/// </returns>
190-
/// <remarks>
191-
/// 此方法执行以下步骤:
192-
/// 1. 获取当前本地时区时间(<see cref="DateTime.Now"/>)
193-
/// 2. 创建 <see cref="DateTimeOffset"/> 对象以保留时区信息
194-
/// 3. 转换为 Unix 时间戳(毫秒级精度)
195-
///
196-
/// 与 <see cref="UnixTimeMilliseconds"/> 方法的区别:
197-
/// - 本方法基于本地时区时间计算
198-
/// - <see cref="UnixTimeMilliseconds"/> 基于 UTC 时间计算
199-
///
200-
/// 毫秒级精度适用于:
201-
/// - 高精度时间计算和比较
202-
/// - 性能监控和基准测试
203-
/// - 需要精确时间差计算的场景
204-
/// </remarks>
205-
/// <example>
206-
/// <code>
207-
/// // 获取当前本地时区的毫秒时间戳
208-
/// long localTimestamp = TimerHelper.NowTimeMilliseconds();
209-
/// Console.WriteLine($"本地时区时间戳(毫秒): {localTimestamp}");
210-
///
211-
/// // 计算代码执行时间
212-
/// long startTime = TimerHelper.NowTimeMilliseconds();
213-
/// // ... 执行某些操作
214-
/// long endTime = TimerHelper.NowTimeMilliseconds();
215-
/// Console.WriteLine($"执行时间: {endTime - startTime} 毫秒");
216-
/// </code>
217-
/// </example>
218-
/// <seealso cref="UnixTimeMilliseconds"/>
219-
/// <seealso cref="NowTimeSeconds"/>
220-
/// <seealso cref="EpochLocal"/>
221-
public static long NowTimeMilliseconds()
222-
{
223-
return new DateTimeOffset(GetNow()).ToUnixTimeMilliseconds();
224-
}
225-
226146
/// <summary>
227147
/// 获取指定时间距离纪元时间的毫秒数。
228148
/// </summary>

0 commit comments

Comments
 (0)