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




Inhaltsverzeichnis