@@ -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