New-TimeSpan

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