New-TimeSpan

  • Referensi
Modul:
Microsoft.PowerShell.Utility

Membuat objek TimeSpan.

Sintaks

New-TimeSpan
   [[-Start] <DateTime>]
   [[-End] <DateTime>]
   [<CommonParameters>]
New-TimeSpan
   [-Days <Int32>]
   [-Hours <Int32>]
   [-Minutes <Int32>]
   [-Seconds <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 defaultnya adalah nol.

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

DateTime

Anda dapat menyalurkan objek DateTime yang mewakili waktu mulai ke cmdlet ini.

Output

TimeSpan

Cmdlet ini mengembalikan objek yang mewakili rentang waktu.