Condividi tramite

New-TimeSpan

Modulo:
Microsoft.PowerShell.Utility Module

Crea un oggetto TimeSpan.

Sintassi

Date (Impostazione predefinita) 

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

Time 

New-TimeSpan
    [-Days <Int32>]
    [-Hours <Int32>]
    [-Minutes <Int32>]
    [-Seconds <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 agli 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 .

$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: Scoprire il TimeSpan dal momento in cui un file è stato aggiornato

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 è un alias di New-TimeSpandi. Quando si invia tramite pipe un oggetto che ha una proprietà LastWriteTime a New-TimeSpan, PowerShell utilizza 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

Specifica i giorni nell'intervallo di tempo. Il valore predefinito è 0.

Proprietà dei parametri

Tipo:Int32
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

Time
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-End

Specifica la fine di un intervallo di tempo. Il valore predefinito è la data e l'ora correnti.

Proprietà dei parametri

Tipo:DateTime
Valore predefinito:Current date and time
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

Date
Posizione:1
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:True
Valore dagli argomenti rimanenti:False

-Hours

Specifica le ore nell'intervallo di tempo. Il valore predefinito è zero.

Proprietà dei parametri

Tipo:Int32
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

Time
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-Minutes

Specifica i minuti nell'intervallo di tempo. Il valore predefinito è 0.

Proprietà dei parametri

Tipo:Int32
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

Time
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-Seconds

Specifica la durata dell'intervallo di tempo in secondi. Il valore predefinito è 0.

Proprietà dei parametri

Tipo:Int32
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

Time
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-Start

Specifica l'inizio di un intervallo di tempo. Immettere una stringa che rappresenta la data e l'ora, ad esempio "3/15/09" o un oggetto DateTime , ad esempio uno da un comando Get-Date. Il valore predefinito è la data e l'ora correnti.

È possibile usare Start o il relativo alias, LastWriteTime. L'alias LastWriteTime consente di inviare tramite pipe gli oggetti con una proprietà LastWriteTime, ad esempio i file nel file system ([IO.FileInfo]), al parametro start di New-TimeSpan.

Proprietà dei parametri

Tipo:DateTime
Valore predefinito:Current date and time
Supporta i caratteri jolly:False
DontShow:False
Alias:LastWriteTime (data e ora dell'ultima modifica)

Set di parametri

Date
Posizione:0
Obbligatorio:False
Valore dalla pipeline:True
Valore dalla pipeline in base al nome della proprietà:True
Valore dagli argomenti rimanenti:False

CommonParameters

Questo cmdlet supporta i parametri comuni: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Per altre informazioni, vedi about_CommonParameters.

Input

DateTime

È possibile inoltrare 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.