Partilhar via

Set-Date

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

Altera a hora do sistema no computador para uma hora que você especificar.

Syntax

Set-Date
   [-Date] <DateTime>
   [-DisplayHint <DisplayHintType>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-Date
   [-Adjust] <TimeSpan>
   [-DisplayHint <DisplayHintType>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

O Set-Date cmdlet altera a data e a hora do sistema no computador para uma data e hora especificadas por você.

Você pode especificar uma nova data e/ou hora digitando uma cadeia de caracteres ou passando um 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 Ajustar .

Exemplos

Exemplo 1: Adicionar três dias à data do sistema

Este comando adiciona três dias à data atual do sistema. Isso não afeta o tempo. O comando usa o parâmetro Date para especificar a data.

O Get-Date cmdlet retorna a data atual como um objeto DateTime . O método AddDays do objeto DateTime adiciona um número especificado de dias (3) ao objeto DateTime atual.

Set-Date -Date (Get-Date).AddDays(3)

Exemplo 2: Acertar o relógio do sistema 10 minutos

Este exemplo define o tempo atual do sistema de volta em 10 minutos.

O parâmetro Adjust permite especificar um intervalo de alteração (menos dez minutos) no formato de hora padrão para a localidade.

O parâmetro DisplayHint diz ao PowerShell para exibir apenas a hora, mas não afeta o objeto DateTime que Set-Date retorna.

Set-Date -Adjust -0:10:0 -DisplayHint Time

Exemplo 3: Definir a data e a hora para um valor variável

Esses comandos alteram a data e a hora do sistema no computador local 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 passar o objeto DateTime para $T o Set-Date cmdlet.

$T = Get-Date
Set-Date -Date $T

Exemplo 4: Adicionar 90 minutos ao relógio do sistema

Esses comandos adiantam o tempo do sistema no computador local em 90 minutos.

O primeiro comando usa o New-TimeSpan cmdlet para criar um objeto TimeSpan com um intervalo de 90 minutos e o salva na $90mins variável.

O segundo comando usa o parâmetro Adjust de Set-Date para ajustar a data pelo valor do objeto TimeSpan na $90mins variável.

$90mins = New-TimeSpan -Minutes 90
Set-Date -Adjust $90mins

Parâmetros

-Adjust

Especifica o valor para o qual esse cmdlet adiciona ou subtrai da data e hora atuais. pode digitar um ajuste no formato de data e hora padrão para sua localidade ou usar o parâmetro Adjust para passar um objeto TimeSpan de New-TimeSpan para Set-Date.

Type:TimeSpan
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Confirm

Solicita a sua confirmação antes de executar o cmdlet.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Date

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 localidade. Ou, você pode passar um objeto DateTime de Get-Date.

Se você especificar uma data, mas não uma hora, Set-Date alterará a hora para meia-noite na data especificada. Se você especificar apenas uma hora, a data não será alterada.

Type:DateTime
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-DisplayHint

Especifica quais elementos da data e hora são exibidos. Os valores aceitáveis para este parâmetro são:

  • Date - exibe apenas a data.
  • Time - exibe apenas o tempo.
  • DateTime - Exibe a data e a hora.

Este parâmetro afeta apenas a exibição. Isso não afeta o objeto DateTime que Get-Date recupera.

Type:DisplayHintType
Accepted values:Date, Time, DateTime
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

Apresenta o que aconteceria mediante a execução do cmdlet. O cmdlet não é executado.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Entradas

DateTime

Você pode canalizar uma data para este cmdlet.

Saídas

DateTime

Este cmdlet retorna um objeto que representa a data definida.

Notas

  • Use este cmdlet com cautela ao alterar a data e a hora no computador. A alteração pode impedir que o computador receba eventos e atualizações em todo o sistema acionados por uma 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 Métodos DateTime e Métodos TimeSpan no SDK do .NET.