Set-Date
Mengubah waktu sistem pada komputer ke waktu yang Anda tentukan.
Sintaks
Date (Default)
Set-Date
[-Date] <DateTime>
[-DisplayHint <DisplayHintType>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Adjust
Set-Date
[-Adjust] <TimeSpan>
[-DisplayHint <DisplayHintType>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Deskripsi
cmdlet Set-Date 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
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
Cmdlet 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
$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 cmdlet
Perintah kedua menggunakan parameter
$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.
Properti parameter
| Jenis: | TimeSpan |
| Nilai default: | None |
| Mendukung wildcard: | False |
| DontShow: | False |
Set parameter
Adjust
| Position: | 0 |
| Wajib: | True |
| Nilai dari alur: | False |
| Nilai dari alur berdasarkan nama properti: | True |
| Nilai dari argumen yang tersisa: | False |
-Confirm
Meminta konfirmasi sebelum menjalankan cmdlet.
Properti parameter
| Jenis: | SwitchParameter |
| Nilai default: | False |
| Mendukung wildcard: | False |
| DontShow: | False |
| Alias: | Cf |
Set parameter
(All)
| Position: | Named |
| Wajib: | False |
| Nilai dari alur: | False |
| Nilai dari alur berdasarkan nama properti: | False |
| Nilai dari argumen yang tersisa: | 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
Jika Anda menentukan tanggal, tetapi bukan waktu, Set-Date mengubah waktu menjadi tengah malam pada tanggal yang ditentukan. Jika Anda hanya menentukan waktu, itu tidak mengubah tanggal.
Properti parameter
| Jenis: | DateTime |
| Nilai default: | None |
| Mendukung wildcard: | False |
| DontShow: | False |
Set parameter
Date
| Position: | 0 |
| Wajib: | True |
| Nilai dari alur: | True |
| Nilai dari alur berdasarkan nama properti: | True |
| Nilai dari argumen yang tersisa: | 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.
Properti parameter
| Jenis: | DisplayHintType |
| Nilai default: | None |
| Nilai yang diterima: | Date, Time, DateTime |
| Mendukung wildcard: | False |
| DontShow: | False |
Set parameter
(All)
| Position: | Named |
| Wajib: | False |
| Nilai dari alur: | False |
| Nilai dari alur berdasarkan nama properti: | False |
| Nilai dari argumen yang tersisa: | False |
-WhatIf
Menunjukkan apa yang akan terjadi ketika cmdlet dijalankan. Cmdlet tidak dijalankan.
Properti parameter
| Jenis: | SwitchParameter |
| Nilai default: | False |
| Mendukung wildcard: | False |
| DontShow: | False |
| Alias: | wi |
Set parameter
(All)
| Position: | Named |
| Wajib: | False |
| Nilai dari alur: | False |
| Nilai dari alur berdasarkan nama properti: | False |
| Nilai dari argumen yang tersisa: | False |
CommonParameters
Cmdlet ini mendukung parameter umum: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, dan -WarningVariable. Untuk informasi selengkapnya, lihat about_CommonParameters.
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 DateTime
dan objek TimeSpan yang digunakan dengan , seperti AddDays ,AddMonths , danFromFileTime . Untuk informasi selengkapnya, lihat Metode DateTime dan Metode Rentang Waktu di .NET SDK.
