Set-Date

  • Referensi
Modul:
Microsoft.PowerShell.Utility

Mengubah waktu sistem pada komputer ke waktu yang Anda tentukan.

Sintaks

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

Deskripsi

Set-Date Cmdlet mengubah tanggal dan waktu sistem pada komputer menjadi tanggal dan waktu yang Anda tentukan.

Anda dapat menentukan tanggal dan/atau waktu baru dengan mengetik string atau dengan meneruskan objek DateTime atau TimeSpan ke Set-Date. Untuk menentukan tanggal atau waktu baru, gunakan parameter Tanggal . Untuk menentukan interval perubahan, gunakan parameter Sesuaikan.

Contoh

Contoh 1: Tambahkan tiga hari ke tanggal sistem

Perintah ini menambahkan tiga hari ke tanggal sistem saat ini. Ini tidak mempengaruhi waktu. Perintah menggunakan parameter Tanggal untuk menentukan tanggal.

Get-Date Cmdlet mengembalikan tanggal saat ini sebagai objek DateTime. Metode AddDays objek DateTime menambahkan jumlah hari tertentu (3) ke objek DateTime saat ini.

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

Contoh 2: Atur jam sistem kembali 10 menit

Contoh ini mengatur waktu sistem saat ini kembali 10 menit.

Parameter Sesuaikan memungkinkan Anda menentukan interval perubahan (minus sepuluh menit) dalam format waktu standar untuk lokal.

Parameter DisplayHint memberi tahu PowerShell untuk menampilkan hanya waktu, tetapi tidak memengaruhi objek DateTime yang Set-Date kembali.

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

Contoh 3: Mengatur tanggal dan waktu ke nilai variabel

Perintah ini mengubah tanggal dan waktu sistem di komputer lokal menjadi tanggal dan waktu yang disimpan dalam variabel $T. Perintah pertama mendapatkan tanggal dan menyimpannya di $T.

Perintah kedua menggunakan parameter Tanggal untuk meneruskan objek $T DateTime ke Set-Date cmdlet.

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

Contoh 4: Tambahkan 90 menit ke jam sistem

Perintah ini memajukan waktu sistem pada komputer lokal sebesar 90 menit.

Perintah pertama menggunakan New-TimeSpan cmdlet untuk membuat objek TimeSpan dengan interval 90 menit, dan menyimpannya dalam $90mins variabel.

Perintah kedua menggunakan parameter Sesuaikan untuk menyesuaikan tanggal menurut nilai objek TimeSpan dalam $90mins variabel.Set-Date

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

Parameter

-Adjust

Menentukan nilai yang ditambahkan atau dikurangi cmdlet ini dari tanggal dan waktu saat ini. dapat mengetikkan penyesuaian dalam format tanggal dan waktu standar untuk lokal Anda atau menggunakan parameter Sesuaikan untuk meneruskanobjek TimeSpan dari New-TimeSpan ke Set-Date.

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

-Confirm

Meminta Anda mengonfirmasi sebelum menjalankan cmdlet.

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

-Date

Mengubah tanggal dan waktu ke nilai yang ditentukan. Anda dapat mengetikkan tanggal baru dalam format tanggal pendek dan waktu dalam format waktu standar untuk lokal Anda. Atau, Anda dapat meneruskan objek DateTime dari Get-Date.

Jika Anda menentukan tanggal, tetapi bukan waktu, Set-Date ubah waktu menjadi tengah malam pada tanggal yang ditentukan. Jika Anda hanya menentukan waktu, itu tidak mengubah tanggal.

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

-DisplayHint

Menentukan elemen tanggal dan waktu mana yang ditampilkan. Nilai yang dapat diterima untuk parameter ini adalah:

  • Date - hanya menampilkan tanggal.
  • Time - hanya menampilkan waktu.
  • DateTime - menampilkan tanggal dan waktu.

Parameter ini hanya memengaruhi tampilan. Ini tidak mempengaruhi objek DateTime yang Get-Date mengambil.

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

-WhatIf

Menunjukkan apa yang akan terjadi jika cmdlet berjalan. Cmdlet tidak dijalankan.

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

Input

DateTime

Anda dapat menyalurkan tanggal ke cmdlet ini.

Output

DateTime

Cmdlet ini mengembalikan objek yang mewakili tanggal yang ditetapkannya.

Catatan

  • Gunakan cmdlet ini dengan hati-hati saat mengubah tanggal dan waktu pada komputer. Perubahan mungkin mencegah komputer menerima peristiwa dan pembaruan di seluruh sistem yang dipicu oleh tanggal atau waktu. Gunakan parameter WhatIf dan Konfirmasi untuk menghindari kesalahan.
  • Anda dapat menggunakan metode .NET standar dengan objek DateTime dan TimeSpan yang digunakan dengan Set-Date, seperti AddDays, AddMonths, dan FromFileTime. Untuk informasi selengkapnya, lihat Metode DateTime dan Metode Rentang Waktu di .NET SDK.