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" 命令會傳回一個代表時間間隔為零的 timespan 物件。
參數
-Days <int>
指出時間範圍涵蓋的天數。預設值為 0。
必要? |
false |
位置? |
named |
預設值 |
0 |
接受管線輸入? |
false |
接受萬用字元? |
false |
-End <DateTime>
指出時間範圍的結束點。預設為目前的日期和時間。
必要? |
false |
位置? |
2 |
預設值 |
目前日期和時間 |
接受管線輸入? |
true (ByPropertyName) |
接受萬用字元? |
false |
-Hours <int>
指出時間範圍涵蓋的小時數。預設為零。
必要? |
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 天之後的日期。