Set-Date
Altera a hora do sistema no computador para uma hora especificada por você.
Sintaxe
Set-Date [-Adjust] <TimeSpan> [-DisplayHint {<Date> | <Time> | <DateTime>}] [-Confirm] [-WhatIf] [<CommonParameters>]
Set-Date [-Date] <DateTime> [-DisplayHint {<Date> | <Time> | <DateTime>}] [-Confirm] [-WhatIf] [<CommonParameters>]
Descrição
O cmdlet Set-Date altera a data e a hora do sistema no computador para a data e a hora especificadas por você. Você pode especificar uma nova data e/ou hora digitando uma cadeia de caracteres ou passando o objeto DateTime ou TimeSpan para Set-Date. Para especificar uma nova data ou hora, use o parâmetro Date. Para especificar um intervalo de alteração, use o parâmetro Adjust.
Parâmetros
-Adjust <TimeSpan>
Adiciona ou subtrai o valor especificado da atual data e hora. Você pode digitar um ajuste no formato de data e hora padrão para sua localidade ou usar o parâmetro Adjust para transmitir um objeto TimeSpan de New-TimeSpan para Set-Date.
Necessário? |
true |
Posição? |
1 |
Valor padrão |
|
Aceitar entrada do pipeline? |
true (ByPropertyName) |
Aceitar caracteres curinga? |
false |
-Date <DateTime>
Altera a data e a hora para os valores especificados. Você pode digitar uma nova data no formato de data abreviada e uma hora no formato de hora padrão para sua localização. Outra opção é transmitir um objeto Date-Time de Get-Date.
Se você especificar uma data, mas não uma hora, o Set-Date irá alterar a hora para meia-noite na data especificada. Se você especificar somente uma hora, ele não irá alterar a data.
Necessário? |
true |
Posição? |
1 |
Valor padrão |
|
Aceitar entrada do pipeline? |
true (ByValue, ByPropertyName) |
Aceitar caracteres curinga? |
false |
-DisplayHint <DisplayHintType>
Determina quais elementos da data e hora serão exibidos.
Os valores válidos são:
-- date: exibe somente a data
-- time: exibe somente a hora
-- datetime: exibe a data e a hora
Esse parâmetro afeta somente a exibição. Ele não afeta o objeto DateTime que o Get-Date recupera.
Necessário? |
false |
Posição? |
named |
Valor padrão |
|
Aceitar entrada do pipeline? |
false |
Aceitar caracteres curinga? |
false |
-Confirm
Solicita confirmação antes da execução do comando.
Necessário? |
false |
Posição? |
named |
Valor padrão |
|
Aceitar entrada do pipeline? |
false |
Aceitar caracteres curinga? |
false |
-WhatIf
Descreve o que aconteceria se você executasse o comando, sem executá-lo de fato.
Necessário? |
false |
Posição? |
named |
Valor padrão |
|
Aceitar entrada do pipeline? |
false |
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 uma data para Set-Date. |
Saídas |
System.DateTime Set-Date retorna um objeto que representa a data estabelecida. |
Observações
Use esse cmdlet com cautela ao alterar a data e a hora no computador. A alteração pode impedir que o computador receba eventos abrangentes do sistema e atualizações acionadas por data ou hora. Use os parâmetros -WhatIf e -Confirm para evitar erros.
Você pode usar métodos .NET padrão com os objetos DateTime e TimeSpan usados com Set-Date, como AddDays, AddMonths e FromFileTime. Para obter mais informações, consulte "DateTime Methods" e "TimeSpan Methods".
Exemplo 1
C:\PS>Set-Date -Date (Get-Date).AddDays(3)
Descrição
-----------
Este comando adiciona três dias à data atual do sistema. Ele não afeta a hora. Este comando usa o parâmetro Date para especificar a data. Ele usa o cmdlet Get-Date para obter a data e a hora atuais e aplica o método .NET AddDays para objetos DateTime com um valor de 3 (dias).
Exemplo 2
C:\PS>set-date -adjust -0:10:0 -displayHint time
Descrição
-----------
Este comando define a hora atual do sistema com um atraso de 10 minutos. Ele usa o parâmetro Adjust para especificar um intervalo de alteração e a alteração de hora (menos 10 minutos) no formato de hora padrão para o local. O parâmetro DisplayHint avisa o Windows PowerShell para que ele exiba somente a hora, mas não afeta o objeto DateTime que Set-Date retorna.
Exemplo 3
C:\PS>$t = get-date
C:\PS>set-date -date $t
Descrição
-----------
Esses comandos alteram a data e a hora do sistema no computador para a data e a hora salvas na variável $t. O primeiro comando obtém a data e a armazena em $t. O segundo comando usa o parâmetro Date para transmitir o objeto DateTime em $t para o cmdlet Set-Date.
Exemplo 4
C:\PS>$90mins = new-timespan -minutes 90
C:\PS>set-date -adjust $90mins
Descrição
-----------
Esses comandos antecipam a hora do sistema no computador local em 90 minutos. O primeiro comando usa o cmdlet New-Timespan para criar um objeto TimeSpan com um intervalo de 90 minutos e, em seguida, salva o objeto TimeSpan na variável $90mins. O segundo comando usa o parâmetro Adjust de Set-Date para ajustar a data pelo valor do objeto TimeSpan na variável $90mins.