New-TimeSpan
Membuat objek TimeSpan.
Sintaks
New-TimeSpan
[[-Start] <DateTime>]
[[-End] <DateTime>]
[<CommonParameters>]
New-TimeSpan
[-Days <Int32>]
[-Hours <Int32>]
[-Minutes <Int32>]
[-Seconds <Int32>]
[-Milliseconds <Int32>]
[<CommonParameters>]
Deskripsi
New-TimeSpan
Cmdlet membuat objek TimeSpan yang mewakili interval waktu.
Anda dapat menggunakan objek TimeSpan untuk menambahkan atau mengurangi waktu dari objek DateTime .
Tanpa parameter, New-TimeSpan
perintah mengembalikan objek TimeSpan yang mewakili interval waktu nol.
Contoh
Contoh 1: Membuat objek TimeSpan untuk durasi tertentu
Perintah ini membuat objek TimeSpan dengan durasi 1 jam dan 25 menit dan menyimpannya dalam variabel bernama $TimeSpan
. Ini menampilkan representasi objek TimeSpan .
$TimeSpan = New-TimeSpan -Hours 1 -Minutes 25
$TimeSpan
Days : 0
Hours : 1
Minutes : 25
Seconds : 0
Milliseconds : 0
Ticks : 51000000000
TotalDays : 0.0590277777777778
TotalHours : 1.41666666666667
TotalMinutes : 85
TotalSeconds : 5100
TotalMilliseconds : 5100000
Contoh 2: Membuat objek TimeSpan untuk interval waktu
Contoh ini membuat objek TimeSpan baru yang mewakili interval antara waktu perintah dijalankan dan 1 Januari 2010.
Perintah ini tidak memerlukan parameter Mulai , karena nilai default parameter Mulai adalah tanggal dan waktu saat ini.
New-TimeSpan -End (Get-Date -Year 2010 -Month 1 -Day 1)
Contoh 3: Dapatkan tanggal 90 hari dari tanggal saat ini
$90days = New-TimeSpan -Days 90
(Get-Date) + $90days
Perintah ini mengembalikan tanggal 90 hari setelah tanggal saat ini.
Contoh 4: Temukan Rentang Waktu karena file diperbarui
Perintah ini memberi tahu Anda berapa lama sejak file bantuan about_remote terakhir diperbarui. Anda dapat menggunakan format perintah ini pada file apa pun, atau objek lain yang memiliki properti LastWriteTime .
Perintah ini berfungsi karena parameter New-TimeSpan
Mulai memiliki alias LastWriteTime. Saat Anda menyalurkan objek yang memiliki properti LastWriteTime ke New-TimeSpan
, PowerShell menggunakan nilai properti LastWriteTime sebagai nilai parameter Mulai .
Get-ChildItem $PSHOME\en-us\about_remote.help.txt | New-TimeSpan
Days : 321
Hours : 21
Minutes : 59
Seconds : 22
Milliseconds : 312
Ticks : 278135623127728
TotalDays : 321.916230471907
TotalHours : 7725.98953132578
TotalMinutes : 463559.371879547
TotalSeconds : 27813562.3127728
TotalMilliseconds : 27813562312.7728
Parameter
-Days
Menentukan hari dalam rentang waktu. Nilai default adalah 0.
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-End
Menentukan akhir rentang waktu. Nilai defaultnya adalah tanggal dan waktu saat ini.
Type: | DateTime |
Position: | 1 |
Default value: | Current date and time |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Hours
Menentukan jam dalam rentang waktu. Nilai default adalah 0.
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Milliseconds
Menentukan panjang rentang waktu dalam milidetik. Nilai default adalah 0.
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Minutes
Menentukan menit dalam rentang waktu. Nilai default adalah 0.
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Seconds
Menentukan panjang rentang waktu dalam detik. Nilai default adalah 0.
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Start
Menentukan awal rentang waktu. Masukkan string yang mewakili tanggal dan waktu, seperti "15/3/09" atau objek DateTime , seperti dari Get-Date
perintah. Nilai defaultnya adalah tanggal dan waktu saat ini.
Anda dapat menggunakan Mulai atau aliasnya, LastWriteTime. Alias LastWriteTime memungkinkan Anda menyalurkan objek yang memiliki properti LastWriteTime, seperti file dalam sistem [System.Io.FileIO]
file , ke parameter Mulai dari New-TimeSpan
.
Type: | DateTime |
Aliases: | LastWriteTime |
Position: | 0 |
Default value: | Current date and time |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
Input
Anda dapat menyalurkan objek DateTime yang mewakili waktu mulai ke cmdlet ini.
Output
Cmdlet ini mengembalikan objek yang mewakili rentang waktu.
Link Terkait
Saran dan Komentar
https://aka.ms/ContentUserFeedback.
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat:Kirim dan lihat umpan balik untuk