PowerShell管道传递中DateTime对象区域性丢失的解决问询

问题场景 #

有两个PowerShell函数get-foo和set-foo：

• get-foo输出包含en-GB格式DateTime对象的自定义对象
• 通过管道将get-foo的输出传给set-foo时，DateTime会被转换为美式日期格式
• 尝试修改set-foo的CreationTime参数默认值为解析后的DateTime时，出现错误：MethodInvocationException: 调用“Parse”时发生异常，参数计数为“1”:“字符串 '' 未被识别为有效的 DateTime。”
  要求：保持set-foo的CreationTime参数为[string]类型，同时让函数尊重会话区域性。

原函数代码 #

get-foo函数 #

Function get-foo{[PSCustomObject]@{Title = 'Some Title' ; CreationTime = [datetime]::Parse('31/01/2023')}}

set-foo函数 #

Function set-foo{  
    [CmdletBinding()]
    Param(
        [Parameter(ValueFromPipelineByPropertyName)]
        [string]$Title,

        [Parameter(ValueFromPipelineByPropertyName)]
        [string]$CreationTime

    )
    Begin{
        ([cultureinfo]::CurrentCulture).Name
    }
    Process{
        $CreationTime
    }
}

测试现象 #

设置会话区域性为en-GB时：

• get-foo输出的CreationTime为31/01/2023 00:00:00
• 通过管道执行get-foo | set-foo后，输出的CreationTime变为01/31/2023 00:00:00（美式格式）

原因分析 #

1. 管道参数绑定的字符串转换规则：PowerShell在通过ValueFromPipelineByPropertyName绑定参数时，会将DateTime对象转换为字符串，这个转换默认使用不变区域性（InvariantCulture），而非当前会话的区域性，导致日期格式被强制转为美式。
2. 默认值解析的空值问题：直接在参数默认值中使用[datetime]::Parse($CreationTime)会报错，因为当未传入CreationTime参数时，变量为空字符串，Parse方法无法解析空值。

解决方案 #

在set-foo的Process块中，对传入的CreationTime字符串进行区域性适配的解析处理，同时增加空值判断避免报错。

修改后的set-foo函数 #

Function set-foo{  
    [CmdletBinding()]
    Param(
        [Parameter(ValueFromPipelineByPropertyName)]
        [string]$Title,

        [Parameter(ValueFromPipelineByPropertyName)]
        [string]$CreationTime

    )
    Begin{
        ([cultureinfo]::CurrentCulture).Name
    }
    Process{
        # 跳过空值或空白字符串
        if ([string]::IsNullOrWhiteSpace($CreationTime)) { return }
        
        # 使用当前会话区域性解析日期字符串
        $parsedDateTime = [datetime]::Parse($CreationTime, [cultureinfo]::CurrentCulture)
        
        # 按当前区域性格式输出，也可直接使用$parsedDateTime对象进行后续处理
        $parsedDateTime.ToString([cultureinfo]::CurrentCulture)
    }
}

更严谨的版本（带格式校验） #

如果需要处理无效日期格式的情况，可使用TryParse方法避免异常：

Function set-foo{  
    [CmdletBinding()]
    Param(
        [Parameter(ValueFromPipelineByPropertyName)]
        [string]$Title,

        [Parameter(ValueFromPipelineByPropertyName)]
        [string]$CreationTime

    )
    Begin{
        ([cultureinfo]::CurrentCulture).Name
    }
    Process{
        if ([string]::IsNullOrWhiteSpace($CreationTime)) { return }
        
        $parsedDateTime = $null
        # 尝试用当前区域性解析日期
        if ([datetime]::TryParse($CreationTime, [cultureinfo]::CurrentCulture, [System.Globalization.DateTimeStyles]::None, [ref]$parsedDateTime)) {
            $parsedDateTime.ToString([cultureinfo]::CurrentCulture)
        } else {
            Write-Warning "无法解析日期字符串: $CreationTime"
        }
    }
}

效果验证 #

设置会话区域性为en-GB后执行get-foo | set-foo，输出将保持31/01/2023 00:00:00，符合en-GB格式要求。

内容的提问来源于stack exchange，提问作者Ralf_Reddings