New-TimeSpan

Modul:
Microsoft.PowerShell.Utility Module

Erstellt ein TimeSpan -Objekt.

Syntax

Date (Standard) 

New-TimeSpan
    [[-Start] <DateTime>]
    [[-End] <DateTime>]
    [<CommonParameters>]

Time 

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 StartparameterNew-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.

Parametereigenschaften

Typ:Int32
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

Time
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-End

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

Parametereigenschaften

Typ:DateTime
Standardwert:Current date and time
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

Date
Position:1
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:True
Wert aus verbleibenden Argumenten:False

-Hours

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

Parametereigenschaften

Typ:Int32
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

Time
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-Milliseconds

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

Parametereigenschaften

Typ:Int32
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

Time
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-Minutes

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

Parametereigenschaften

Typ:Int32
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

Time
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-Seconds

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

Parametereigenschaften

Typ:Int32
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

Time
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten: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 ([IO.FileInfo]), an den Startparameter von New-TimeSpan.

Parametereigenschaften

Typ:DateTime
Standardwert:Current date and time
Unterstützt Platzhalter:False
Nicht anzeigen:False
Aliase:Letzte Schreibzeit

Parametersätze

Date
Position:0
Obligatorisch.:False
Wert aus Pipeline:True
Wert aus Pipeline nach dem Eigenschaftsnamen:True
Wert aus verbleibenden Argumenten:False

CommonParameters

Dieses Cmdlet unterstützt die allgemeinen Parameter -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen findest du unter about_CommonParameters.

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.