Set-Date
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.
Anda harus memiliki hak administratif untuk mengubah tanggal dan waktu sistem. Di Windows, mulai PowerShell dengan opsi Jalankan sebagai administrator .
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
5: Ubah ke tanggal dan waktu tertentu
Contoh berikut mengatur tanggal dan waktu ke nilai tertentu.
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
Parameter
-Adjust
Menentukan nilai yang ditambahkan atau dikurangi cmdlet ini dari tanggal dan waktu saat ini. Anda dapat mengetikkan penyesuaian dalam format tanggal dan waktu standar untuk lokal Anda atau menggunakan parameter Sesuaikan untuk meneruskan objek TimeSpan dari New-TimeSpan
ke Set-Date
.
Jenis: | TimeSpan |
Position: | 0 |
Nilai default: | None |
Diperlukan: | True |
Terima input alur: | True |
Terima karakter wildcard: | False |
-Confirm
Meminta Anda mengonfirmasi sebelum menjalankan cmdlet.
Jenis: | SwitchParameter |
Alias: | cf |
Position: | Named |
Nilai default: | False |
Diperlukan: | False |
Terima input alur: | False |
Terima karakter wildcard: | 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.
Jenis: | DateTime |
Position: | 0 |
Nilai default: | None |
Diperlukan: | True |
Terima input alur: | True |
Terima karakter wildcard: | 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 memengaruhi objek DateTime yang Get-Date
mengambil.
Jenis: | DisplayHintType |
Nilai yang diterima: | Date, Time, DateTime |
Position: | Named |
Nilai default: | None |
Diperlukan: | False |
Terima input alur: | False |
Terima karakter wildcard: | False |
-WhatIf
Menunjukkan apa yang akan terjadi jika cmdlet berjalan. Cmdlet tidak dijalankan.
Jenis: | SwitchParameter |
Alias: | wi |
Position: | Named |
Nilai default: | False |
Diperlukan: | False |
Terima input alur: | False |
Terima karakter wildcard: | False |
Input
Anda dapat menyalurkan tanggal ke cmdlet ini.
Output
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.