New-TimeSpan

Sintassi

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

New-TimeSpan
   [-Days <Int32>]
   [-Hours <Int32>]
   [-Minutes <Int32>]
   [-Seconds <Int32>]
   [-Milliseconds <Int32>]
   [<CommonParameters>]

Descrizione

Il cmdlet crea un oggetto TimeSpan che rappresenta un intervallo di tempo. È possibile utilizzare un oggetto TimeSpan per aggiungere o sottrarre tempo da oggetti DateTime.

Senza parametri, un comando New-TimeSpan restituisce un oggetto timeSpan che rappresenta un intervallo di tempo pari a zero.

Esempio

Esempio 1: Creare un oggetto TimeSpan per una durata specificata

Questo comando crea un oggetto timeSpan di con una durata di 1 ora e 25 minuti e lo archivia in una variabile denominata . Visualizza una rappresentazione dell'oggetto TimeSpan di .

$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

Esempio 2: Creare un oggetto TimeSpan per un intervallo di tempo

In questo esempio viene creato un nuovo oggetto TimeSpan che rappresenta l'intervallo tra l'esecuzione del comando e il 1° gennaio 2010.

Questo comando non richiede il parametro Start, perché il valore predefinito del parametro Start è la data e l'ora correnti.

New-TimeSpan -End (Get-Date -Year 2010 -Month 1 -Day 1)

Esempio 3: Ottenere la data 90 giorni dalla data corrente

$90days = New-TimeSpan -Days 90
(Get-Date) + $90days

Questi comandi restituiscono la data di 90 giorni dopo la data corrente.

Esempio 4: Individuare TimeSpan dopo l'aggiornamento di un file

Questo comando indica quanto tempo è trascorso dall'ultimo aggiornamento del file della Guida about_remote. È possibile utilizzare questo formato di comando in qualsiasi file o in qualsiasi altro oggetto con una proprietà LastWriteTime .

Questo comando funziona perché il parametro Start di di ha un alias di LastWriteTime. Quando si invia tramite pipe un oggetto con una proprietà LastWriteTime a , PowerShell usa il valore della proprietà LastWriteTime come valore del parametro Start .

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

Parametri

-Days

-End

-Hours

-Milliseconds

-Minutes

-Seconds

-Start

Input

DateTime

È possibile inviare tramite pipe un oggetto DateTime che rappresenta l'ora di inizio a questo cmdlet.

Output

TimeSpan

Questo cmdlet restituisce un oggetto che rappresenta l'intervallo di tempo.

Collegamenti correlati

• Get-Date
• Set-Date