New-TimeSpan
Crea un oggetto TimeSpan.
Sintassi
New-TimeSpan [[-Start] <DateTime>] [[-End] <DateTime>] [<CommonParameters>]
New-TimeSpan [-Days <int>] [-Hours <int>] [-Minutes <int>] [-Seconds <int>] [<CommonParameters>]
Descrizione
Il cmdlet New-TimeSpan crea un oggetto TimeSpan che rappresenta un intervallo di tempo. È possibile utilizzare tali oggetto per aggiungere o sottrarre tempo dagli oggetti DateTime.
Senza parametri, un comando New-Timespan restituisce un oggetto TimeSpan che rappresenta un intervallo di tempo pari a zero.
Parametri
-Days <int>
Indica i giorni nell'intervallo di tempo. L'impostazione predefinita è 0.
Obbligatorio? |
false |
Posizione? |
named |
Valore predefinito |
0 |
Accettare input da pipeline? |
false |
Accettare caratteri jolly? |
false |
-End <DateTime>
Indica la fine di un intervallo di tempo. L'impostazione predefinita è rappresentata da data e ora correnti.
Obbligatorio? |
false |
Posizione? |
2 |
Valore predefinito |
Current date and time |
Accettare input da pipeline? |
true (ByPropertyName) |
Accettare caratteri jolly? |
false |
-Hours <int>
Indica le ore nell'intervallo di tempo. L'impostazione predefinita è zero.
Obbligatorio? |
false |
Posizione? |
named |
Valore predefinito |
0 |
Accettare input da pipeline? |
false |
Accettare caratteri jolly? |
false |
-Minutes <int>
Indica i minuti nell'intervallo di tempo. L'impostazione predefinita è 0.
Obbligatorio? |
false |
Posizione? |
named |
Valore predefinito |
0 |
Accettare input da pipeline? |
false |
Accettare caratteri jolly? |
false |
-Seconds <int>
Indica la durata dell'intervallo di tempo in secondi. L'impostazione predefinita è 0.
Obbligatorio? |
false |
Posizione? |
named |
Valore predefinito |
0 |
Accettare input da pipeline? |
false |
Accettare caratteri jolly? |
false |
-Start <DateTime>
Indica l'inizio di un intervallo di tempo. Immettere una stringa che rappresenta la data e l'ora, ad esempio 15/03/09 o un oggetto DateTime, ad esempio ottenuto da un comando Get-Date.
L'impostazione predefinita è rappresentata da data e ora correnti.
Obbligatorio? |
false |
Posizione? |
1 |
Valore predefinito |
Current date and time |
Accettare input da pipeline? |
true (ByValue, ByPropertyName) |
Accettare caratteri jolly? |
false |
<CommonParameters>
Questo cmdlet supporta i parametri comuni -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer e -OutVariable. Per ulteriori informazioni, vedere about_Commonparameters.
Input e output
Il tipo di input è il tipo degli oggetti che è possibile reindirizzare al cmdlet. Il tipo restituito è il tipo degli oggetti restituiti dal cmdlet.
Input |
System.DateTime È possibile reindirizzare un oggetto DateTime che rappresenta l'ora di inizio a New-TimeSpan. |
Output |
System.Timespan New-TimeSpan restituisce un oggetto che rappresenta l'intervallo di tempo. |
Esempio 1
C:\PS>$timespan = new-timespan -hour 1 -minute 25
Descrizione
-----------
Con questo comando verrà creato un oggetto TimeSpan con una durata di 1 ora e 25 minuti, che verrà archiviato in una variabile denominata $timespan. Verrà quindi visualizzata una rappresentazione dell'oggetto TimeSpan.
Esempio 2
C:\PS>new-timespan -end (get-date -year 2010 -month 1 -day 1)
Descrizione
-----------
In questo esempio viene creato un nuovo oggetto TimeSpan che rappresenta l'intervallo tra l'ora di esecuzione del comando e il 1 gennaio 2010.
Questo comando non richiede il parametro Start, perché il valore predefinito del parametro Start è rappresentato dalla data e dall'ora correnti.
Esempio 3
C:\PS>$90days = new-timespan -days 90
C:\PS> (get-date) + $90days
Descrizione
-----------
Questi comandi restituiscono la data di 90 giorni successiva alla data corrente.