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.