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