Erstellt ein TimeSpan-Objekt.
Syntax
New-TimeSpan [[-Start] <DateTime>] [[-End] <DateTime>] [<CommonParameters>] New-TimeSpan [-Days <int>] [-Hours <int>] [-Minutes <int>] [-Seconds <int>] [<CommonParameters>]
Beschreibung
Das Cmdlet "New-TimeSpan" erstellt ein TimeSpan-Objekt, das ein Zeitintervall darstellt. Mit einem TimeSpan-Objekt können Sie Zeit von DateTime-Objekten subtrahieren oder zu DateTime-Objekten addieren.
Ohne Parameter gibt ein New-Timespan-Befehl ein TimeSpan-Objekt zurück, das ein Zeitintervall von 0 (null) darstellt.
Parameter
-Days <int>
Gibt die Tage in der Zeitspanne an. Der Standardwert ist 0.
|
Erforderlich? |
false |
|
Position? |
named |
|
Standardwert |
0 |
|
Pipelineeingaben akzeptieren? |
false |
|
Platzhalterzeichen akzeptieren? |
false |
-End <DateTime>
Gibt das Ende einer Zeitspanne an. Der Standard ist das aktuelle Datum und die aktuelle Uhrzeit.
|
Erforderlich? |
false |
|
Position? |
2 |
|
Standardwert |
Current date and time |
|
Pipelineeingaben akzeptieren? |
true (ByPropertyName) |
|
Platzhalterzeichen akzeptieren? |
false |
-Hours <int>
Gibt die Stunden in der Zeitspanne an. Der Standardwert ist 0 (null).
|
Erforderlich? |
false |
|
Position? |
named |
|
Standardwert |
0 |
|
Pipelineeingaben akzeptieren? |
false |
|
Platzhalterzeichen akzeptieren? |
false |
-Minutes <int>
Gibt die Minuten in der Zeitspanne an. Der Standardwert ist 0.
|
Erforderlich? |
false |
|
Position? |
named |
|
Standardwert |
0 |
|
Pipelineeingaben akzeptieren? |
false |
|
Platzhalterzeichen akzeptieren? |
false |
-Seconds <int>
Gibt die Länge der Zeitspanne in Sekunden an. Der Standardwert ist 0.
|
Erforderlich? |
false |
|
Position? |
named |
|
Standardwert |
0 |
|
Pipelineeingaben akzeptieren? |
false |
|
Platzhalterzeichen akzeptieren? |
false |
-Start <DateTime>
Gibt den Beginn einer Zeitspanne an. Geben Sie eine Zeichenfolge ein, die das Datum und die Uhrzeit darstellt, z. B. "15.3.09", oder ein DateTime-Objekt, z. B. ein Objekt aus einem Get-Date-Befehl.
Der Standard ist das aktuelle Datum und die aktuelle Uhrzeit.
|
Erforderlich? |
false |
|
Position? |
1 |
|
Standardwert |
Current date and time |
|
Pipelineeingaben akzeptieren? |
true (ByValue, ByPropertyName) |
|
Platzhalterzeichen akzeptieren? |
false |
<CommonParameters>
Dieses Cmdlet unterstützt die folgenden allgemeinen Parameter: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer und -OutVariable. Weitere Informationen finden Sie unter about_Commonparameters.
Eingaben und Ausgaben
Der Eingabetyp ist der Typ der Objekte, die über die Pipeline an das Cmdlet übergeben werden können. Der Rückgabetyp ist der Typ der Objekte, die das Cmdlet zurückgibt.
|
Eingaben |
System.DateTime Sie können über die Pipeline ein DateTime-Objekt übergeben, das die Startzeit für New-TimeSpan darstellt. |
|
Ausgaben |
System.Timespan New-TimeSpan gibt ein Objekt zurück, das die Zeitspanne darstellt. |
Beispiel 1
C:\PS>$timespan = new-timespan -hour 1 -minute 25 Beschreibung ----------- In diesem Befehl wird ein TimeSpan-Objekt mit einer Dauer von 1 Stunde und 25 Minuten erstellt und in der Variablen "$timespan" gespeichert. Zeigt eine Darstellung des TimeSpan-Objekts an.
Beispiel 2
C:\PS>new-timespan -end (get-date -year 2010 -month 1 -day 1) Beschreibung ----------- In diesem Beispiel wird ein neues TimeSpan-Objekt erstellt, das das Intervall zwischen der Ausführung des Befehls und dem 1. Januar 2010 darstellt. Dieser Befehl benötigt keinen Start-Parameter, weil der Standardwert des Start-Parameters dem aktuellen Datum und der aktuellen Uhrzeit entspricht.
Beispiel 3
C:\PS>$90days = new-timespan -days 90 C:\PS> (get-date) + $90days Beschreibung ----------- Diese Befehle geben das Datum zurück, das 90 Tage nach dem aktuellen Datum liegt.
Siehe auch