Freigeben über

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>]
   [-Milliseconds <Int32>]
   [<CommonParameters>]

Beschreibung

Das cmdlet New-TimeSpan 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

Mit diesem Befehl wird ein TimeSpan -Objekt mit einer Dauer von 1 Stunde und 25 Minuten erstellt und in einer Variablen namens $TimeSpangespeichert. 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 parameter Start nicht erforderlich, da der Standardwert des Start--Parameters 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 beliebiges anderes Objekt mit einer LastWriteTime--Eigenschaft verwenden.

Dieser Befehl funktioniert, da der Start--Parameter von New-TimeSpan einen Alias von LastWriteTime-hat. 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.

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. eines aus einem Get-Date Befehl. Der Standardwert ist das aktuelle Datum und die aktuelle Uhrzeit.

Sie können Start- oder dessen 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 New-TimeSpanübergeben.

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.