Cria um objeto TimeSpan.
Sintaxe
New-TimeSpan [[-Start] <DateTime>] [[-End] <DateTime>] [<CommonParameters>] New-TimeSpan [-Days <int>] [-Hours <int>] [-Minutes <int>] [-Seconds <int>] [<CommonParameters>]
Descrição
O cmdlet New-TimeSpan cria um objeto TimeSpan que representa um intervalo de tempo. Você pode usar um objeto TimeSpan para adicionar ou subtrair tempo de objetos DateTime.
Sem parâmetros, um comando "New-Timespan" retorna um objeto TimeSpan que representa um intervalo de tempo igual a zero.
Parâmetros
-Days <int>
Indica os dias no intervalo de tempo. O padrão é 0.
|
Necessário? |
false |
|
Posição? |
named |
|
Valor padrão |
0 |
|
Aceitar entrada do pipeline? |
false |
|
Aceitar caracteres curinga? |
false |
-End <DateTime>
Indica o final de um intervalo de tempo. O padrão é a data e a hora atuais.
|
Necessário? |
false |
|
Posição? |
2 |
|
Valor padrão |
Current date and time |
|
Aceitar entrada do pipeline? |
true (ByPropertyName) |
|
Aceitar caracteres curinga? |
false |
-Hours <int>
Indica as horas no intervalo de tempo. O padrão é zero.
|
Necessário? |
false |
|
Posição? |
named |
|
Valor padrão |
0 |
|
Aceitar entrada do pipeline? |
false |
|
Aceitar caracteres curinga? |
false |
-Minutes <int>
Indica os minutos no intervalo de tempo. O padrão é 0.
|
Necessário? |
false |
|
Posição? |
named |
|
Valor padrão |
0 |
|
Aceitar entrada do pipeline? |
false |
|
Aceitar caracteres curinga? |
false |
-Seconds <int>
Indica a duração do intervalo de tempo em segundos. O padrão é 0.
|
Necessário? |
false |
|
Posição? |
named |
|
Valor padrão |
0 |
|
Aceitar entrada do pipeline? |
false |
|
Aceitar caracteres curinga? |
false |
-Start <DateTime>
Indica o início de um intervalo de tempo. Insira uma sequência que representa a data e a hora, como "3/15/09" ou um objeto DateTime, como um de um comando Get-Date.
O padrão é a data e a hora atuais.
|
Necessário? |
false |
|
Posição? |
1 |
|
Valor padrão |
Current date and time |
|
Aceitar entrada do pipeline? |
true (ByValue, ByPropertyName) |
|
Aceitar caracteres curinga? |
false |
<CommonParameters>
Esse cmdlet oferece suporte aos parâmetros comuns: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer e -OutVariable. Para obter mais informações, consulte about_Commonparameters.
Entradas e saídas
O tipo de entrada é o tipo dos objetos que você pode canalizar para o cmdlet. O tipo de retorno é o tipo dos objetos que o cmdlet retorna.
|
Entradas |
System.DateTime Você pode canalizar um objeto DateTime que representa aquela hora de início para New-TimeSpan. |
|
Saídas |
System.Timespan New-TimeSpan retorna um objeto que representa o intervalo de tempo. |
Exemplo 1
C:\PS>$timespan = new-timespan -hour 1 -minute 25 Descrição ----------- Esse comando cria um objeto TimeSpan com uma duração de 1 hora e 25 minutos e o armazena em uma variável denominada $timespan. Ele exibe uma representação do objeto TimeSpan.
Exemplo 2
C:\PS>new-timespan -end (get-date -year 2010 -month 1 -day 1) Descrição ----------- Esse exemplo cria um novo objeto TimeSpan que representa o intervalo entre o momento em que o comando é executado e 1 de janeiro de 2010. Esse comando não requer o parâmetro Start, pois o valor padrão do parâmetro Start é a data e a hora atuais.
Exemplo 3
C:\PS>$90days = new-timespan -days 90 C:\PS> (get-date) + $90days Descrição ----------- Esses comandos retornam a data, que é 90 dias após a data atual.
See Also