Set-Date (Microsoft.PowerShell.Utility)

Set-Date

将计算机上的系统时间更改为您指定的时间。

句法

Set-Date
   [-Date] <DateTime>
   [-DisplayHint <DisplayHintType>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-Date
   [-Adjust] <TimeSpan>
   [-DisplayHint <DisplayHintType>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

描述

Set-Date cmdlet 将计算机上的系统日期和时间更改为您指定的日期和时间。

您可以通过键入字符串或将 DateTime 或 TimeSpan 对象传递给 Set-Date 来指定新的日期和/或时间。要指定新的日期或时间，请使用日期参数。要指定更改间隔，请使用调整参数。

您必须拥有管理权限才能更改系统日期和时间。在 Windows 上，使用以管理员身份运行选项启动 PowerShell。

示例

示例1：在系统日期上添加三天

此命令在当前系统日期的基础上添加三天。不影响时间。该命令使用日期参数来指定日期。

Get-Date cmdlet 将当前日期作为 DateTime 对象返回。 DateTime 对象的 AddDays 方法将指定的天数 (3) 添加到当前 DateTime 对象。

Set-Date -Date (Get-Date).AddDays(3)

示例2：将系统时钟调慢10分钟

此示例将当前系统时间向后设置 10 分钟。

调整参数允许您指定区域设置的标准时间格式的更改间隔（负十分钟）。

DisplayHint 参数告诉 PowerShell 仅显示时间，但它不会影响 Set-Date 返回的 DateTime 对象。

Set-Date -Adjust -0:10:0 -DisplayHint Time

示例 3：将日期和时间设置为变量值

这些命令将本地计算机上的系统日期和时间更改为变量 $T 中保存的日期和时间。第一个命令获取日期并将其存储在 $T 中。

第二个命令使用 Date 参数将 $T 中的 DateTime 对象传递给 Set-Date cmdlet。

$T = Get-Date
Set-Date -Date $T

示例 4：向系统时钟添加 90 分钟

这些命令将本地计算机上的系统时间提前 90 分钟。

第一个命令使用 New-TimeSpan cmdlet 创建间隔为 90 分钟的 TimeSpan 对象，并将其保存在 $90mins 变量中。

第二个命令使用 Set-Date 的 Adjust 参数，通过 TimeSpan 对象的值在 $90mins 内调整日期变量。

$90mins = New-TimeSpan -Minutes 90
Set-Date -Adjust $90mins

5：更改为特定日期和时间

以下示例将日期和时间设置为特定值。

PS> Get-Date

Monday, June 10, 2024 2:05:48 PM

PS> Set-Date '6/11/2024 2:05:48 PM'

Tuesday, June 11, 2024 2:05:48 PM

参数

-Adjust

指定此 cmdlet 在当前日期和时间中添加或减去的值。您可以针对您的区域设置以标准日期和时间格式键入调整，或使用 Adjust 参数将 TimeSpan 对象从 New-TimeSpan 传递到设置日期。

TimeSpan

0

None

True

True

False

-Confirm

在运行 cmdlet 之前提示您进行确认。

SwitchParameter

cf

命名

False

False

False

False

-Date

将日期和时间更改为指定值。您可以以短日期格式键入新日期，并以适合您所在区域的标准时间格式键入时间。或者，您可以从 Get-Date 传递 DateTime 对象。

如果您指定日期，但未指定时间，Set-Date 会将时间更改为指定日期的午夜。如果您仅指定时间，则不会更改日期。

DateTime

0

None

True

True

False

-DisplayHint

指定显示日期和时间的哪些元素。该参数可接受的值为：

• 日期 - 仅显示日期。
• 时间 - 仅显示时间。
• DateTime - 显示日期和时间。

该参数仅影响显示。它不会影响 Get-Date 检索的 DateTime 对象。

显示提示类型

日期、时间、日期时间

命名

None

False

False

False

-WhatIf

显示 cmdlet 运行时会发生什么情况。该 cmdlet 未运行。

SwitchParameter

wi

命名

False

False

False

False

输入

日期时间

您可以通过管道将日期传递给此 cmdlet。

输出

日期时间

此 cmdlet 返回一个表示它设置的日期的对象。

笔记

• 更改计算机上的日期和时间时请谨慎使用此 cmdlet。此更改可能会阻止计算机接收由日期或时间触发的系统范围事件和更新。使用 WhatIf 和 Confirm 参数以避免错误。
• 您可以将标准 .NET 方法与与 Set-Date 一起使用的 DateTime 和 TimeSpan 对象结合使用，例如 AddDays 、添加月份和FromFileTime。有关详细信息，请参阅 .NET SDK 中的 DateTime 方法和 TimeSpan 方法。