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

Data e a hora atuais

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

Data e a hora atuais

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.





Consulte também

Conceitos

Set-Date
Get-Date