New-TimeSpan
Cria um objeto TimeSpan.
Sintaxe
Date (Predefinição)
New-TimeSpan
[[-Start] <DateTime>]
[[-End] <DateTime>]
[<CommonParameters>]
Time
New-TimeSpan
[-Days <Int32>]
[-Hours <Int32>]
[-Minutes <Int32>]
[-Seconds <Int32>]
[<CommonParameters>]
Description
O cmdlet
Sem parâmetros, um comando
Exemplos
Exemplo 1: Criar um objeto TimeSpan para uma duração especificada
Este 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 TimeSpan objeto.
$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 a hora em que o comando é executado e 1º de janeiro de 2010.
Este 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
Esses comandos retornam a data que é 90 dias após a data atual.
Exemplo 4: Descubra o TimeSpan desde que um arquivo foi atualizado
Este comando informa há quanto tempo o arquivo de ajuda 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
Este 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 período de tempo. O valor padrão é 0.
Propriedades dos parâmetros
| Tipo: | Int32 |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
Time
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
-End
Especifica o fim de um período de tempo. O valor padrão é a data e hora atuais.
Propriedades dos parâmetros
| Tipo: | DateTime |
| Default value: | Current date and time |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
Date
| Position: | 1 |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | True |
| Valor dos restantes argumentos: | False |
-Hours
Especifica as horas no período de tempo. O valor padrão é zero.
Propriedades dos parâmetros
| Tipo: | Int32 |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
Time
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
-Minutes
Especifica os minutos no intervalo de tempo. O valor padrão é 0.
Propriedades dos parâmetros
| Tipo: | Int32 |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
Time
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
-Seconds
Especifica o período de tempo em segundos. O valor padrão é 0.
Propriedades dos parâmetros
| Tipo: | Int32 |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
Time
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | 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
Você pode usar Start ou seu alias, LastWriteTime. O alias LastWriteTime permite canalizar objetos que têm uma propriedade LastWriteTime, como arquivos no sistema de arquivos ([IO.FileInfo]), para o parâmetro Start de New-TimeSpan.
Propriedades dos parâmetros
| Tipo: | DateTime |
| Default value: | Current date and time |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
| Aliases: | HoraDaÚltimaEscrita |
Conjuntos de parâmetros
Date
| Position: | 0 |
| Obrigatório: | False |
| Valor do pipeline: | True |
| Valor do pipeline por nome de propriedade: | True |
| Valor dos restantes argumentos: | False |
CommonParameters
Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters.
Entradas
DateTime
Você pode canalizar um objeto DateTime que representa a hora de início para este cmdlet.
Saídas
TimeSpan
Este cmdlet retorna um objeto que representa o período de tempo.
