如下说明是翻译: help New-TimeSpan 产生的帮助信息.
译者: Edengundam(马涛)
New-TimeSpan
大纲
创建一个TimeSpan对象.
语法
New-TimeSpan [[-start] <DateTime>] [[-end] <DateTime>] [<CommonParameters>]
New-TimeSpan [-days <int>] [-hours <int>] [-minutes <int>] [-seconds <int>] [<CommonParameters>]
详细描述
创建一个TimeSpan对象. 可以从DateTime对象上加减命令所输出的对象, 来来创建另一个DateTime对象. (译注: TimeSpan类似数据库中的INTERVAL类型, 表示两个时间点的差, 接下来我们将timespan翻译为”时间跨度”)
参数
-start <DateTime>
指定时间跨度的起始点.
强制参数?
|
false
|
参数位置?
|
1
|
默认值
|
|
允许从管道绑定输入?
|
true (根据值, 根据属性名)
|
允许通配符扩展?
|
false
|
-end <DateTime>
指定时间跨度的终止点.
强制参数?
|
false
|
参数位置?
|
2
|
默认值
|
Now
|
允许从管道绑定输入?
|
true (根据属性名)
|
允许通配符扩展?
|
false
|
-days <int>
制定时间跨度中的天数.
强制参数?
|
false
|
参数位置?
|
named
|
默认值
|
|
允许从管道绑定输入?
|
false
|
允许通配符扩展?
|
false
|
-hours <int>
制定时间跨度中的小时数.
强制参数?
|
false
|
参数位置?
|
named
|
默认值
|
|
允许从管道绑定输入?
|
false
|
允许通配符扩展?
|
false
|
-minutes <int>
制定时间跨度中的分钟数.
强制参数?
|
false
|
参数位置?
|
named
|
默认值
|
|
允许从管道绑定输入?
|
false
|
允许通配符扩展?
|
false
|
-seconds <int>
制定时间跨度中的秒数.
强制参数?
|
false
|
参数位置?
|
named
|
默认值
|
|
允许从管道绑定输入?
|
false
|
允许通配符扩展?
|
false
|
<公共参数>
此命令支持公共参数: -Verbose, -Debug, -ErrorAction, -ErrorVariable, and -OutVariable. 更多信息, 输入, "get-help about_commonparameters".
输入类型
None
返回类型
TimeSpan对象
注意
更多信息, 输入"Get-Help New-TimeSpan -detailed".需要技术信息, 输入"Get-Help New-TimeSpan -full".
如果需要为该命令提供多个参数, 请使用逗号进行分隔. 例如, "<parameter-name> <value1>, <value2>".
例1
C:/PS>$timespan = new-timespan -hour 1 -minute 25
此命令创建TimeSpan对象表示1小时25分钟的时间跨度, 并将其存储在名为$timespan的变量中. 它将会显示TimeSpan对象的表示形式.(译注: 这句话意思很可能是你在PowerShell中再执行一次$timespan操作. 例子中的命令不输出任何信息.)
例2
C:/PS>$timespan = new-timespan (get-date -year 1970 -month 02 -day 26)
此例子中创建一个新的TimeSpan对象来表示从命令开始运行到1970年2月26日之间的时间跨度.
相关链接
Set-Date
Get-Date