Freigeben über


New-TimeSpan

Erstellt ein TimeSpan-Objekt.

Syntax

New-TimeSpan
   [[-Start] <DateTime>]
   [[-End] <DateTime>]
   [<CommonParameters>]
New-TimeSpan
   [-Days <Int32>]
   [-Hours <Int32>]
   [-Minutes <Int32>]
   [-Seconds <Int32>]
   [-Milliseconds <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: Erstellen 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 namens $TimeSpan. Es zeigt eine Darstellung des TimeSpan-Objekts an.

$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: Erstellen 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 Startparameter nicht erforderlich, da der Standardwert des Startparameters 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 ab dem 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 des TimeSpans 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 eine beliebige Datei oder ein anderes Objekt verwenden, das eine LastWriteTime-Eigenschaft aufweist.

Dieser Befehl funktioniert, da der Startparameter New-TimeSpan über einen Alias von LastWriteTime verfügt. Wenn Sie ein Objekt mit einer LastWriteTime-Eigenschaft an New-TimeSpanein Objekt übergeben, verwendet PowerShell den Wert der LastWriteTime-Eigenschaft als Wert des Startparameters .

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.

Typ:Int32
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-End

Gibt das Ende einer Zeitspanne an. Der Standardwert ist das aktuelle Datum und die aktuelle Uhrzeit.

Typ:DateTime
Position:1
Standardwert:Current date and time
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-Hours

Gibt die Stunden in der Zeitspanne an. Der Standardwert ist 0.

Typ:Int32
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Milliseconds

Gibt die Länge der Zeitspanne in Millisekunden an. Der Standardwert ist 0.

Typ:Int32
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Minutes

Gibt die Minuten in der Zeitspanne an. Der Standardwert ist 0.

Typ:Int32
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Seconds

Gibt die Länge der Zeitspanne in Sekunden an. Der Standardwert ist 0.

Typ:Int32
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Start

Gibt den Anfang einer Zeitspanne an. Geben Sie eine Zeichenfolge ein, die das Datum und die Uhrzeit darstellt, z. B. "3.15.09" oder ein DateTime-Objekt, z. B. ein Objekt aus einem Get-Date Befehl. Der Standardwert ist das aktuelle Datum und die aktuelle Uhrzeit.

Sie können "Start" oder deren 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 Startparameter von New-TimeSpan.

Typ:DateTime
Aliase:LastWriteTime
Position:0
Standardwert:Current date and time
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

Eingaben

DateTime

Sie können ein DateTime-Objekt weiterleiten, das die Startzeit an dieses Cmdlet darstellt.

Ausgaben

TimeSpan

Dieses Cmdlet gibt ein Objekt zurück, das die Zeitspanne darstellt.