Share via

New-TimeSpan

  • Referenz
Modul:
Microsoft.PowerShell.Utility

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

DateTime

Sie können ein DateTime-Objekt , das diese Startzeit darstellt, an übergeben New-TimeSpan.

Ausgaben

TimeSpan

New-TimeSpan gibt ein Objekt zurück, das die Zeitspanne darstellt.