Set-Date

  • Referencia
Módulo:
Microsoft.PowerShell.Utility

Cambia la hora del sistema del equipo a la hora que especifique.

Sintaxis

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

Description

El Set-Date cmdlet cambia la fecha y hora del sistema en el equipo a una fecha y hora que especifique.

Puede especificar una nueva fecha o hora escribiendo una cadena o pasando un objeto DateTime o TimeSpan a Set-Date. Para especificar una nueva fecha u hora, use el parámetro Date . Para especificar un intervalo de cambio, use el parámetro Adjust .

Debe tener derechos administrativos para cambiar la fecha y hora del sistema. En Windows, inicie PowerShell con la opción Ejecutar como administrador .

Ejemplos

Ejemplo 1: Agregar tres días a la fecha del sistema

Este comando suma tres días a la fecha actual del sistema. No afecta al tiempo. El comando usa el parámetro Date para especificar la fecha.

El Get-Date cmdlet devuelve la fecha actual como un objeto DateTime . El método AddDays del objeto DateTime agrega un número especificado de días (3) al objeto DateTime actual.

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

Ejemplo 2: Establecer el reloj del sistema 10 minutos atrás

En este ejemplo se establece el tiempo actual del sistema en 10 minutos.

El parámetro Adjust permite especificar un intervalo de cambio (menos diez minutos) en el formato de hora estándar para la configuración regional.

El parámetro DisplayHint indica a PowerShell que muestre solo la hora, pero no afecta al objeto DateTime que Set-Date devuelve.

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

Ejemplo 3: Establecer la fecha y hora en un valor de variable

Estos comandos cambian la fecha y hora del sistema en el equipo local a la fecha y hora guardadas en la variable $T. El primer comando obtiene la fecha y la almacena en $T.

El segundo comando usa el parámetro Date para pasar el objeto DateTime al $T Set-Date cmdlet .

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

Ejemplo 4: Agregar 90 minutos al reloj del sistema

Estos comandos adelantan 90 minutos la hora del sistema en el equipo local.

El primer comando usa el New-TimeSpan cmdlet para crear un objeto TimeSpan con un intervalo de 90 minutos y lo guarda en la $90mins variable .

El segundo comando usa el parámetro Adjust de Set-Date para ajustar la fecha por el valor del objeto TimeSpan en la $90mins variable.

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

5: Cambiar a una fecha y hora específicas

En el ejemplo siguiente se establece la fecha y hora en un valor específico.

PS> Get-Date

Monday, June 10, 2024 2:05:48 PM

PS> Set-Date '6/11/2024 2:05:48 PM'

Tuesday, June 11, 2024 2:05:48 PM

Parámetros

-Adjust

Especifica el valor para el que este cmdlet agrega o resta de la fecha y hora actuales. Puede escribir un ajuste en formato de fecha y hora estándar para la configuración regional o usar el parámetro Adjust para pasar un objeto TimeSpan de New-TimeSpan a Set-Date.

Tipo:TimeSpan
Posición:0
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-Confirm

Le solicita su confirmación antes de ejecutar el cmdlet.

Tipo:SwitchParameter
Alias:cf
Posición:Named
Valor predeterminado:False
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Date

Cambia la fecha y hora a los valores especificados. Se puede escribir una fecha nueva en el formato corto de fecha y una hora en el formato de hora estándar en la configuración regional. O bien, puede pasar un objeto DateTime desde Get-Date.

Si especifica una fecha, pero no una hora, Set-Date cambia la hora a medianoche en la fecha especificada. Si especifica solo una hora, no cambia la fecha.

Tipo:DateTime
Posición:0
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-DisplayHint

Especifica qué elementos de la fecha y hora se muestran. Los valores permitidos para este parámetro son los siguientes:

  • Date : muestra solo la fecha.
  • Time : muestra solo la hora.
  • DateTime : muestra la fecha y hora.

Este parámetro afecta únicamente a la visualización. No afecta al objeto DateTime que Get-Date recupera.

Tipo:DisplayHintType
Valores aceptados:Date, Time, DateTime
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-WhatIf

Muestra lo que sucedería si se ejecutara el cmdlet. El cmdlet no se ejecuta.

Tipo:SwitchParameter
Alias:wi
Posición:Named
Valor predeterminado:False
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

Entradas

DateTime

Puede canalizar una fecha a este cmdlet.

Salidas

DateTime

Este cmdlet devuelve un objeto que representa la fecha establecida.

Notas

  • Use este cmdlet con precaución al cambiar la fecha y hora en el equipo. podría hacer que el equipo no reciba los eventos y actualizaciones de todo el sistema que se activan a partir de una fecha o una hora. Use los parámetros WhatIf y Confirm para evitar errores.
  • Puede usar métodos estándar de .NET con los objetos DateTime y TimeSpan usados con Set-Date, como AddDays, AddMonths y FromFileTime. Para obtener más información, vea Métodos DateTime y Métodos TimeSpan en el SDK de .NET.