建立 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

預設值

Current date and time

接受管線輸入?

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

預設值

Current date and time

接受管線輸入?

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 天之後的日期。






請參閱




目錄