Erstellt ein TimeSpan-Objekt. (New-TimeSpan)

   

NAME
New-TimeSpan

# ÜBERSICHT
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 Aktuelles Datum und aktuelle Uhrzeit
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 Aktuelles Datum und aktuelle Uhrzeit
Pipelineeingaben akzeptieren?true (ByValue, ByPropertyName)
Platzhalterzeichen akzeptieren?false

<CommonParameters>
Dieses Cmdlet unterstützt folgende allgemeine Parameter: "Verbose", "Debug",
"ErrorAction", "ErrorVariable", "WarningAction", "WarningVariable",
"OutBuffer" und "OutVariable". Weitere Informationen
erhalten Sie mit dem Befehl "get-help about_commonparameters".

# 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.

# HINWEISE

# 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.

VERWANDTE LINKS
Online version: http://go.microsoft.com/fwlink/?LinkID=113360 (möglicherweise auf Englisch)
Set-Date
Get-Date

C:\Windows>powershell get-help Read-Host -full

ColorConsole [Version 1.7.1000] PowerShell 2.0-Export
Microsoft Windows [Version 6.1.7600]
Copyright (c) 2014 Microsoft Corporation.