New-TimeSpan
创建 TimeSpan 对象。
语法
New-TimeSpan [[-Start] <DateTime>] [[-End] <DateTime>] [<CommonParameters>]
New-TimeSpan [-Days <int>] [-Hours <int>] [-Minutes <int>] [-Seconds <int>] [<CommonParameters>]
说明
New-TimeSpan cmdlet 创建表示时间间隔的 TimeSpan 对象。可以使用 TimeSpan 对象对 DateTime 对象进行时间的加或减操作。
如果不使用参数，则“New-Timespan”命令返回表示零时间间隔的时间跨度对象。
参数
-Days <int>
指示时间跨度中的天数。默认值为 0。
是否为必需？ |
false |
位置？ |
named |
默认值 |
0 |
是否接受管道输入？ |
false |
是否接受通配符？ |
false |
-End <DateTime>
指示时间跨度的结束。默认值为当前日期和时间。
是否为必需？ |
false |
位置？ |
2 |
默认值 |
当前日期和时间 |
是否接受管道输入？ |
true (ByPropertyName) |
是否接受通配符？ |
false |
-Hours <int>
指示时间跨度中的小时数。默认值为 0。
是否为必需？ |
false |
位置？ |
named |
默认值 |
0 |
是否接受管道输入？ |
false |
是否接受通配符？ |
false |
-Minutes <int>
指示时间跨度中的分钟数。默认值为 0。
是否为必需？ |
false |
位置？ |
named |
默认值 |
0 |
是否接受管道输入？ |
false |
是否接受通配符？ |
false |
-Seconds <int>
指示时间跨度的长度，以秒为单位。默认值为 0。
是否为必需？ |
false |
位置？ |
named |
默认值 |
0 |
是否接受管道输入？ |
false |
是否接受通配符？ |
false |
-Start <DateTime>
指示时间跨度的开始。输入一个表示日期和时间的字符串（如“3/15/09”）或一个 DateTime 对象（如 Get-Date 命令返回的对象）。
默认值为当前日期和时间。
是否为必需？ |
false |
位置？ |
1 |
默认值 |
当前日期和时间 |
是否接受管道输入？ |
true (ByValue, ByPropertyName) |
是否接受通配符？ |
false |
<CommonParameters>
此 cmdlet 支持通用参数：-Verbose、-Debug、-ErrorAction、-ErrorVariable、-OutBuffer 和 -OutVariable。有关详细信息，请参阅 about_Commonparameters.
输入和输出
输入类型是指可通过管道传递给 cmdlet 的对象的类型。返回类型是指 Cmdlet 所返回对象的类型。
输入 |
System.DateTime 可以通过管道将表示开始时间的 DateTime 对象传递给 New-TimeSpan。 |
输出 |
System.Timespan New-TimeSpan 返回表示时间跨度的对象。 |
示例 1
C:\PS>$timespan = new-timespan -hour 1 -minute 25
说明
-----------
此命令创建持续时间为 1 小时 25 分钟的 TimeSpan 对象，并将它存储在名为 $timespan 的变量中。它显示 TimeSpan 对象的表示形式。
示例 2
C:\PS>new-timespan -end (get-date -year 2010 -month 1 -day 1)
说明
-----------
此示例创建新的 TimeSpan 对象，该对象表示从命令运行时到 2010 年 1 月 1 日之间的时间间隔。
此命令不需要 Start 参数，因为 Start 参数的默认值是当前日期和时间。
示例 3
C:\PS>$90days = new-timespan -days 90
C:\PS> (get-date) + $90days
说明
-----------
这些命令返回当前日期之后 90 天时的日期。