Set-Date 帮助信息

 

如下说明是翻译 : help Set-Date 产生的帮助信息 .

译者 : Edengundam( 马涛 )

 

Set-Date

 

大纲

修改计算机上的时间为指定时间 .

 

语法

Set-Date [-date] <DateTime> [-displayHint {<Date> | <Time> | <DateTime>}] [-whatIf] [-confirm] [<CommonParameters>]

 

Set-Date [-adjust] <TimeSpan> [-displayHint {<Date> | <Time> | <DateTime>}] [-whatIf] [-confirm] [<CommonParameters>]

 

参数

Set-Date cmdlet 修改计算机上的时间为指定时间 . 你可以为新时间日期指定一个字符串 , 或传递一个 DateTime 或 TimeSpan 对象 . 使用参数 Date 指定一个新的时间 . 使用参数 Adjust 来指定一个时间间隔 .

 

参数

 

-date <DateTime>

改变日期和时间为指定的时间 . 你可以输入一个本地的日期缩写格式或标准日期格式 , 来指定新的时间 . 你也可以为 Get-Date 传递一个 Date-Time 对象 .

 

如果你只指定了日期 , 而没有时间 , Set-Date 将会改变时间为指定时间的午夜 (00:00). 如果你只指定了时间 , 此命令不会修改日期 .

 

强制参数 ?	true
参数位置 ?	1
默认值	系统时间
允许从管道绑定输入 ?	true ( 根据值 , 根据属性名 )
允许通配符扩展 ?	false

 

-displayHint <DisplayHintType>

指定日期和对象中哪些元素被显示 . ( 此命令不会影响通过 Get-Date 取得的 DateTime 对象 .)

 

合法取值为 :

 

·          date: 只显示日期

·          time: 只显示时间

·          datetime: 显示日期和时间

 

如下列出此参数接受的参数 :

 

·          Date

·          Time

·          DateTime

 

强制参数 ?	false
参数位置 ?	named
默认值	DateTime
允许从管道绑定输入 ?	false
允许通配符扩展 ?	false

 

-adjust <TimeSpan>

从当前日期和时间中加上或减去指定的值 . 你可以输入一个你的当地日期时间标准格式的调整值或者使用参数 Adjust 给 Set-Date 传递一个通过 New-TimeSpan 取得的 TimeSpan 对象 .

 

强制参数 ?	true
参数位置 ?	1
默认值	0
允许从管道绑定输入 ?	true ( 根据属性名 )
允许通配符扩展 ?	false

 

-whatIf

描述执行此命令将会发生的现象 , 不会真正执行此命令 .

 

强制参数 ?	false
参数位置 ?	named
默认值
允许从管道绑定输入 ?	false
允许通配符扩展 ?	false

 

-confirm

执行命令前提示你进行确认 .

 

强制参数 ?	false
参数位置 ?	named
默认值
允许从管道绑定输入 ?	false
允许通配符扩展 ?	false

 

< 公共参数 >

此命令支持公共参数 : -Verbose, -Debug, -ErrorAction, -ErrorVariable, and -OutVariable. 更多信息 , 输入 , "get-help about_commonparameters".

 

输入类型

DateTime Object, TimeSpan Object

 

返回类型

DateTime Object

 

注意

 

更多信息 , 输入 "Get-Help Set-Date -detailed". 需要技术信息 , 输入 "Get-Help Set-Date -full".

 

使用此命令时请务必小心 , 此命令将会修改计算机时间 . 时间的修改可能会阻止计算机接收和更新那些依赖日期时间除法的系统事件 . 使用参数 -WhatIf 和 -Confirm 来尽量避免错误 .

 

你可以在使用 Set-Date 时 , 使用标准的 DateTime 和 TimeSpan 对象上的 .NET 方法 , 例如 : AddDays, AddMonths 和 FromFileTime. 需要更多的信息 , 请查看 "DateTime Methods" 和 "TimeSpan Methods."

 

如果需要为该命令提供多个参数 , 请使用逗号进行分隔 . 例如 , "<parameter-name> <value1>, <value2>".

 

例 1

 

C:/PS>Set-Date -Date (Get-Date).AddDays(3)

 

此命令在当前系统时间上添加三天 , 但是不会影响时间 . 此命令使用了参数 Date 来指定日期 . 首先是用 Get-Date cmdlet 取得当前日期和时间 , 然后使用 .NET DateTime 对象上的方法 AddDays ( 参数为三天 ).

 

例 2

 

C:/PS>set-date -adjust -0:10:0 -displayHint time

 

此命令设置时间为系统当前时间的 10 分钟之前 . 此命令使用参数 Adjust 指定改变的时间间隔 . 改变的时间 ( 负 10 分钟 ) 表示为本地的标准时间格式 . 参数 DisplayHint 提示 Windows PowerShell 只显示时间 , 但是此参数不会影响 Set-Date 返回的 DateTime 对象 .

 

例 3

 

C:/PS>$t = get-date

 

C:/PS>set-date -date $t

 

此命令改变系统的日期和时间为变量 $t 保存的日期和时间 . 第一个命令取得日期和时间并存储在变量 $t 中 . 第二个命令使用参数 Date 将 $t 中的 DateTime 对象传递给 Set-Date cmdlet.

 

例 4

 

C:/PS>$90mins = new-timespan -minutes 90

 

C:/PS>set-date -adjust $90mins

 

这些命令可以将系统时间提前 90 分钟 . 第一个命令使用 New-Timespan cmdlet 创建一个 90 分钟时间间隔的 TimeSpan 对象 , 然后将 TimeSpan 对象存储在 $90mins 变量中 . 第二个命令使用 Set-Date 参数 Adjust, 根据变量 $90mins 中 TimeSpan 对象的值来调整日期 .

 

相关链接

Get-Date

New-TimeSpan