New-TimeSpan 帮助信息

如下说明是翻译 : 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