New-TimeSpan
Erstellt ein TimeSpan-Objekt.
Syntax
New-TimeSpan
[[-Start] <DateTime>]
[[-End] <DateTime>]
[<CommonParameters>]
New-TimeSpan
[-Days <Int32>]
[-Hours <Int32>]
[-Minutes <Int32>]
[-Seconds <Int32>]
[<CommonParameters>]
Beschreibung
Das New-TimeSpan
Cmdlet erstellt ein TimeSpan-Objekt , das ein Zeitintervall darstellt.
Sie können ein TimeSpan-Objekt verwenden, um Zeit von DateTime-Objekten hinzuzufügen oder zu subtrahieren.
Ohne Parameter gibt ein New-TimeSpan
Befehl ein TimeSpan-Objekt zurück, das ein Zeitintervall von null darstellt.
Beispiele
Beispiel 1: Create eines TimeSpan-Objekts für eine angegebene Dauer
Dieser Befehl erstellt ein TimeSpan-Objekt mit einer Dauer von 1 Stunde und 25 Minuten und speichert es in einer Variablen mit dem Namen $TimeSpan
. Es wird eine Darstellung des TimeSpan-Objekts angezeigt.
$TimeSpan = New-TimeSpan -Hours 1 -Minutes 25
$TimeSpan
Days : 0
Hours : 1
Minutes : 25
Seconds : 0
Milliseconds : 0
Ticks : 51000000000
TotalDays : 0.0590277777777778
TotalHours : 1.41666666666667
TotalMinutes : 85
TotalSeconds : 5100
TotalMilliseconds : 5100000
Beispiel 2: Create eines TimeSpan-Objekts für ein Zeitintervall
In diesem Beispiel wird ein neues TimeSpan-Objekt erstellt, das das Intervall zwischen der Ausführung des Befehls und dem 1. Januar 2010 darstellt.
Für diesen Befehl ist der Start-Parameter nicht erforderlich, da der Standardwert des Parameters Start das aktuelle Datum und die aktuelle Uhrzeit ist.
New-TimeSpan -End (Get-Date -Year 2010 -Month 1 -Day 1)
Beispiel 3: Abrufen des Datums 90 Tage vom aktuellen Datum
$90days = New-TimeSpan -Days 90
(Get-Date) + $90days
Diese Befehle geben das Datum zurück, das 90 Tage nach dem aktuellen Datum liegt.
Beispiel 4: Ermitteln der TimeSpan seit der Aktualisierung einer Datei
Mit diesem Befehl erfahren Sie, wie lange die about_remote Hilfedatei zuletzt aktualisiert wurde. Sie können dieses Befehlsformat für jede Datei oder jedes andere Objekt verwenden, das über eine LastWriteTime-Eigenschaft verfügt.
Dieser Befehl funktioniert, da der Start-Parameter von New-TimeSpan
über einen Alias von LastWriteTime verfügt. Wenn Sie ein Objekt mit einer LastWriteTime-Eigenschaft an New-TimeSpan
übergeben, verwendet PowerShell den Wert der LastWriteTime-Eigenschaft als Wert des Start-Parameters .
Get-ChildItem $PSHOME\en-us\about_remote.help.txt | New-TimeSpan
Days : 321
Hours : 21
Minutes : 59
Seconds : 22
Milliseconds : 312
Ticks : 278135623127728
TotalDays : 321.916230471907
TotalHours : 7725.98953132578
TotalMinutes : 463559.371879547
TotalSeconds : 27813562.3127728
TotalMilliseconds : 27813562312.7728
Parameter
-Days
Gibt die Tage in der Zeitspanne an. Der Standardwert ist 0.
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-End
Gibt das Ende einer Zeitspanne an. Der Standardwert ist das aktuelle Datum und die aktuelle Uhrzeit.
Type: | DateTime |
Position: | 1 |
Default value: | Current date and time |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Hours
Gibt die Stunden in der Zeitspanne an. Der Standardwert ist 0 (null).
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Minutes
Gibt die Minuten in der Zeitspanne an. Der Standardwert ist 0.
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Seconds
Gibt die Länge der Zeitspanne in Sekunden an. Der Standardwert ist 0.
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Start
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. eines aus einem Get-Date
Befehl. Der Standardwert ist das aktuelle Datum und die aktuelle Uhrzeit.
Sie können Start oder den zugehörigen Alias LastWriteTime verwenden.
Mit dem LastWriteTime-Alias können Sie Objekte mit einer LastWriteTime-Eigenschaft , z. B. Dateien im Dateisystem [System.Io.FileIO]
, an den Start-Parameter von übergeben New-TimeSpan
.
Type: | DateTime |
Aliases: | LastWriteTime |
Position: | 0 |
Default value: | Current date and time |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
Eingaben
Sie können ein DateTime-Objekt , das diese Startzeit darstellt, an übergeben New-TimeSpan
.
Ausgaben
New-TimeSpan
gibt ein Objekt zurück, das die Zeitspanne darstellt.