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.

-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.

-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.

-Confirm

Solicita confirmação antes da execução do comando.

-WhatIf

Descreve o que aconteceria se você executasse o comando, sem executá-lo de fato.

<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.

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.

Consulte também

Conceitos

Get-Date
New-TimeSpan