Set-Date

Меняет системное время компьютера на указанное.

Синтаксис

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

Описание

Командлет Set-Date изменяет системную дату и время на компьютере на указанную дату и время. Вы можете указать новую дату и (или) время, введя строку или передав объект Set-DateDateTime или TimeSpan. Чтобы указать новую дату или время, используйте параметр Date . Чтобы указать интервал изменения, используйте параметр Adjust .

Примеры

Пример 1. Добавление трех дней к системной дате

Эта команда добавляет к текущей системной дате три дня. На время она не влияет. Команда использует параметр Date для указания даты.

Командлет Get-Date возвращает текущую дату в виде объекта DateTime . Метод AddDays объекта DateTime добавляет указанное количество дней (3) к текущему объекту DateTime.

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

Пример 2. Установка системных часов назад 10 минут

В этом примере задается текущее системное время назад на 10 минут.

Параметр Adjust позволяет указать интервал изменения (минус десять минут) в стандартном формате времени для языкового стандарта.

Параметр DisplayHint сообщает PowerShell отображать только время, но не влияет на возвращаемый Set-Date объект DateTime.

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

Пример 3. Установка значения даты и времени для переменной

Эти команды изменяют системную дату и время на локальном компьютере на дату и время, сохраненные в переменной $T. Первая команда получает дату и сохраняет ее в $T.

Вторая команда использует параметр Date для передачи объекта DateTime в $TSet-Date командлет.

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

Пример 4. Добавление 90 минут в системные часы

Эти команды переводят системное время на локальном компьютере на 90 минут вперед.

Первая команда использует New-TimeSpan командлет для создания объекта TimeSpan с интервалом в 90 минут и сохраняет его в переменной $90mins .

Вторая команда использует параметр Adjust для Set-Date настройки даты по значению объекта TimeSpan в переменной $90mins .

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

Параметры

-Adjust

Указывает значение, для которого этот командлет добавляет или вычитает из текущей даты и времени. может ввести корректировку в стандартном формате даты и времени для языкового стандарта или использовать параметр Adjust для передачи объекта TimeSpan из New-TimeSpanSet-Date.

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

-Confirm

Запрос подтверждения перед выполнением командлета.

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

-Date

Устанавливает указанные значения даты и времени. Можно ввести новую дату в кратком формате даты, а время — в стандартном формате времени для используемого языкового стандарта. Кроме того, можно передать объект DateTime из Get-Date.

Если указать дату, но не время, Set-Date измените время на полночь указанной даты. Если указано только время, дата не изменяется.

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

-DisplayHint

Указывает, какие элементы даты и времени отображаются. Допустимые значения для этого параметра:

  • Дата — отображает только дату.
  • Время — отображает только время.
  • DateTime — отображает дату и время.

Этот параметр влияет только на отображаемые значения Он не влияет на извлекаемый объект Get-DateDateTime.

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

-WhatIf

Показывает, что произойдет при запуске командлета. Командлет не выполняется.

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

Входные данные

DateTime

Вы можете передать дату в Set-Date.

Выходные данные

DateTime

Set-Date возвращает объект, представляющий заданную дату.

Примечания

  • Используйте этот командлет осторожно при изменении даты и времени на компьютере. Из-за изменения даты или времени компьютер может не получать системные события и обновления, которые запускаются в определенный день или момент времени. Используйте параметры WhatIf и Confirm , чтобы избежать ошибок.

  • Стандартные методы .NET можно использовать с объектами DateTime и TimeSpan, используемыми с Set-Dateтакими объектами, как AddDays, AddMonths и FromFileTime. Дополнительные сведения см. в разделе "Методы DateTime " и

    Методы TimeSpan в пакете SDK .NET.