命令行与文本处理 / 系统课时
处理日期与时间
处理日期与时间
本课解决脚本中日期创建、固定格式解析、时间差计算、时区转换和格式化输出问题。完成后,你能用不依赖本机区域设置的方式处理业务时间,避免同一字符串在不同服务器上被解释成不同日期。
学习目标
- 使用
DateTimeOffset创建和解析带偏移量的时间 - 计算两个时间点之间的持续时间并转换时区
- 使用固定文化和明确格式避免区域设置歧义
选择合适的时间类型
PowerShell 中常见的 [datetime] 对应 .NET DateTime,适合表示本地时间、UTC 时间或未指定时区的日历值;[datetimeoffset] 同时保存日期时间和 UTC 偏移量,更适合订单时间、接口时间戳和跨时区日志。
业务数据只要涉及“这个时间点在全球对应哪一刻”,优先使用 DateTimeOffset。只有生日、结算日期等不强调瞬时时刻的值,才适合仅保存日期或未指定时区的 DateTime。
固定格式解析与时间差
不要直接依赖 [datetime]"04/08/2026" 这类含糊字符串,因为不同区域设置可能把它解释为 4 月 8 日或 8 月 4 日。应明确格式,并使用 InvariantCulture 解析。
using namespace System.Globalization
$invariant = [CultureInfo]::InvariantCulture
# 输入同时包含日期、时间和 UTC 偏移量,因此使用 DateTimeOffset。
$start = [DateTimeOffset]::ParseExact(
"2026-08-04 09:30:00 +08:00",
"yyyy-MM-dd HH:mm:ss zzz",
$invariant
)
$end = [DateTimeOffset]::ParseExact(
"2026-08-04 12:00:00 +08:00",
"yyyy-MM-dd HH:mm:ss zzz",
$invariant
)
$duration = $end - $start
# Windows 与 Linux 的时区标识不同,依次尝试 IANA 和 Windows 标识。
try {
$tokyoZone = [TimeZoneInfo]::FindSystemTimeZoneById("Asia/Tokyo")
}
catch {
$tokyoZone = [TimeZoneInfo]::FindSystemTimeZoneById("Tokyo Standard Time")
}
$tokyo = [TimeZoneInfo]::ConvertTime($start, $tokyoZone)
"StartIso={0}" -f $start.ToString("o")
"Duration={0}h{1}m" -f [int]$duration.TotalHours, $duration.Minutes
"Utc={0}" -f $start.UtcDateTime.ToString("yyyy-MM-dd HH:mm:ss 'UTC'")
"Tokyo={0}" -f $tokyo.ToString("yyyy-MM-dd HH:mm:ss zzz")预期输出
StartIso=2026-08-04T09:30:00.0000000+08:00
Duration=2h30m
Utc=2026-08-04 01:30:00 UTC
Tokyo=2026-08-04 10:30:00 +09:00示例中的日期固定,因此输出可复现。实际脚本若使用 Get-Date,时间值会随运行时刻变化,应在日志或测试中使用 <TIME> 表示动态时间。
格式化与解析边界
ToString("o") 生成 ISO 8601 往返格式,适合接口和日志;ToString("yyyy-MM-dd HH:mm:ss zzz") 适合人工阅读。格式化只改变文本表现,不会改变对象保存的真实时间点。
外部输入无法保证正确时,使用 TryParseExact 比捕获异常更适合批量处理。还要避免把没有偏移量的字符串直接当作 UTC;若来源明确为 UTC,应显式追加 Z 或使用带 DateTimeStyles.AssumeUniversal 的解析方式。
时区转换应通过 TimeZoneInfo 完成,不要手工加减小时。夏令时地区的偏移量会随日期变化,固定加 8 或减 5 小时可能在部分日期产生错误。