Set-Date

Změní systémový čas v počítači na zadaný čas.

Syntax

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

Description

Rutina Set-Date změní systémové datum a čas v počítači na datum a čas, které zadáte.

Nové datum nebo čas můžete zadat zadáním řetězce nebo předáním objektu DateTime nebo TimeSpan do Set-Date. Pokud chcete zadat nové datum nebo čas, použijte parametr Date . Chcete-li zadat interval změn, použijte parametr Upravit .

Příklady

Příklad 1: Přidání tří dnů do systémového data

Tento příkaz přidá k aktuálnímu systémovému datu tři dny. Nemá vliv na čas. Příkaz použije parametr Date k určení data.

Rutina Get-Date vrátí aktuální datum jako objekt DateTime . Metoda AddDaysobjektu DateTime přidá zadaný počet dní (3) k aktuálnímu objektu DateTime.

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

Příklad 2: Nastavení systémových hodin zpět 10 minut

Tento příklad nastaví aktuální systémový čas zpět o 10 minut.

Parametr Adjust umožňuje zadat interval změny (minus deset minut) ve standardním formátu času národního prostředí.

Parametr DisplayHint říká PowerShellu, aby zobrazil pouze čas, ale nemá vliv na objekt DateTime, který Set-Date vrací.

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

Příklad 3: Nastavení data a času na hodnotu proměnné

Tyto příkazy změní systémové datum a čas v místním počítači na datum a čas uložený v proměnné $T. První příkaz získá datum a uloží ho do $T.

Druhý příkaz použije parametr Date k předání objektu $TDateTime do rutinySet-Date.

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

Příklad 4: Přidání 90 minut do systémového času

Tyto příkazy posílají systémový čas na místním počítači o 90 minut.

První příkaz použije rutinu New-TimeSpan k vytvoření objektu TimeSpan s intervalem 90 minut a uloží ho $90mins do proměnné.

Druhý příkaz použije parametr Set-DateAdjust k úpravě data podle hodnoty objektu TimeSpan v $90mins proměnné.

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

Parametry

-Adjust

Určuje hodnotu, pro kterou tato rutina sčítá nebo odečte od aktuálního data a času. může zadat úpravu ve standardním formátu data a času pro národní prostředí nebo pomocí parametru Adjust předat objekt TimeSpan z New-TimeSpan do Set-Date.

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

-Confirm

Před spuštěním rutiny zobrazí výzvu k potvrzení.

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

-Date

Změní datum a čas na zadané hodnoty. Nové datum můžete zadat v krátkém formátu data a času ve standardním formátu času pro národní prostředí. Nebo můžete předat objekt DateTime z Get-Date.

Pokud zadáte datum, ale ne čas, Set-Date změní se čas na půlnoc v zadaném datu. Pokud zadáte jenom čas, nezmění se datum.

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

-DisplayHint

Určuje, které prvky data a času se zobrazí. Přijatelné hodnoty pro tento parametr jsou:

  • Date - zobrazí jenom datum.
  • Time - zobrazí jenom čas.
  • DateTime - zobrazí datum a čas.

Tento parametr má vliv pouze na zobrazení. Nemá vliv na objekt DateTime , který Get-Date se načte.

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

-WhatIf

Zobrazuje, co by se stalo při spuštění rutiny. Rutina není spuštěna.

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

Vstupy

DateTime

Datum můžete roušit na Set-Date.

Výstupy

DateTime

Set-Date vrátí objekt, který představuje datum, které nastaví.

Poznámky

  • Tuto rutinu používejte opatrně při změně data a času v počítači. Tato změna může bránit počítači v přijímání událostí a aktualizací pro celý systém, které se aktivují datem nebo časem. Pomocí parametrů WhatIf a Confirm se vyhnete chybám.
  • Standardní metody .NET můžete použít s objekty DateTime a TimeSpan , které se používají s Set-Dateobjekty , jako jsou AddDays, AddMonths a FromFileTime. Další informace naleznete v tématu Metody DateTime a Metody TimeSpan v sadě .NET SDK.