New-TimeSpan

  • Referência
Módulo:
Microsoft.PowerShell.Utility

Cria um objeto TimeSpan.

Syntax

New-TimeSpan
   [[-Start] <DateTime>]
   [[-End] <DateTime>]
   [<CommonParameters>]
New-TimeSpan
   [-Days <Int32>]
   [-Hours <Int32>]
   [-Minutes <Int32>]
   [-Seconds <Int32>]
   [-Milliseconds <Int32>]
   [<CommonParameters>]

Description

O New-TimeSpan cmdlet 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 New-TimeSpan comando retorna um objeto TimeSpan que representa um intervalo de tempo de zero.

Exemplos

Exemplo 1: Criar um objeto TimeSpan para uma duração especificada

Esse comando cria um objeto TimeSpan com duração de 1 hora e 25 minutos e o armazena em uma variável chamada $TimeSpan. Ele exibe uma representação do objeto 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

Exemplo 2: Criar um objeto TimeSpan para um intervalo de tempo

Este exemplo cria um novo objeto TimeSpan que representa o intervalo entre o horário de execução do comando e 1º de janeiro de 2010.

Esse comando não requer o parâmetro Start , porque o valor padrão do parâmetro Start é a data e hora atuais.

New-TimeSpan -End (Get-Date -Year 2010 -Month 1 -Day 1)

Exemplo 3: Obter a data 90 dias a partir da data atual

$90days = New-TimeSpan -Days 90
(Get-Date) + $90days

Estes comandos retornam a data que é de 90 dias depois da data atual.

Exemplo 4: Descobrir o TimeSpan desde que um arquivo foi atualizado

Esse comando informa há quanto tempo o arquivo de ajuda do about_remote foi atualizado pela última vez. Você pode usar esse formato de comando em qualquer arquivo ou qualquer outro objeto que tenha uma propriedade LastWriteTime .

Esse comando funciona porque o parâmetro Start de New-TimeSpan tem um alias de LastWriteTime. Quando você canaliza um objeto que tem uma propriedade LastWriteTime para New-TimeSpan, o PowerShell usa o valor da propriedade LastWriteTime como o valor do parâmetro 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

Parâmetros

-Days

Especifica os dias no intervalo de tempo. O valor padrão é 0.

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-End

Especifica o final de um período de tempo. O valor padrão é a data e hora atuais.

Type:DateTime
Position:1
Default value:Current date and time
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Hours

Especifica as horas no intervalo de tempo. O valor padrão é 0.

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Milliseconds

Especifica a duração do intervalo de tempo em milissegundos. O valor padrão é 0.

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Minutes

Especifica os minutos no intervalo de tempo. O valor padrão é 0.

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Seconds

Especifica a duração do intervalo de tempo em segundos. O valor padrão é 0.

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Start

Especifica o início de um período de tempo. Insira uma cadeia de caracteres que represente a data e a hora, como "15/03/09" ou um objeto DateTime , como um de um Get-Date comando. O valor padrão é a data e hora atuais.

Você pode usar Start ou seu alias, LastWriteTime. O alias LastWriteTime permite canalizar objetos que têm uma propriedade LastWriteTime , como arquivos no sistema [System.Io.FileIO]de arquivos, para o parâmetro Start de New-TimeSpan.

Type:DateTime
Aliases:LastWriteTime
Position:0
Default value:Current date and time
Required:False
Accept pipeline input:True
Accept wildcard characters:False

Entradas

DateTime

Você pode canalizar um objeto DateTime que representa a hora de início para esse cmdlet.

Saídas

TimeSpan

Esse cmdlet retorna um objeto que representa o período de tempo.