New-TimeSpan

Modul:
Microsoft.PowerShell.Utility Module

Membuat objek TimeSpan.

Sintaks

Date (Default) 

New-TimeSpan
    [[-Start] <DateTime>]
    [[-End] <DateTime>]
    [<CommonParameters>]

Time 

New-TimeSpan
    [-Days <Int32>]
    [-Hours <Int32>]
    [-Minutes <Int32>]
    [-Seconds <Int32>]
    [-Milliseconds <Int32>]
    [<CommonParameters>]

Deskripsi

Cmdlet membuat objek TimeSpan yang mewakili interval waktu. Anda dapat menggunakan objek TimeSpan untuk menambahkan atau mengurangi waktu dari objek DateTime .

Tanpa parameter, perintah New-TimeSpan 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: Ketahui Durasi Waktu sejak 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 Mulai dari New-TimeSpan memiliki alias LastWriteTime. Saat Anda menyalurkan objek yang memiliki properti LastWriteTime ke , 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 defaultnya adalah 0.

Properti parameter

Jenis:Int32
Nilai default:None
Mendukung wildcard:False
DontShow:False

Kumpulan parameter

Time
Position:Named
Wajib:False
Nilai dari alur:False
Nilai dari alur berdasarkan nama properti:False
Nilai dari argumen yang tersisa:False

-End

Menentukan akhir rentang waktu. Nilai defaultnya adalah tanggal dan waktu saat ini.

Properti parameter

Jenis:DateTime
Nilai default:Current date and time
Mendukung wildcard:False
DontShow:False

Kumpulan parameter

Date
Position:1
Wajib:False
Nilai dari alur:False
Nilai dari alur berdasarkan nama properti:True
Nilai dari argumen yang tersisa:False

-Hours

Menentukan jumlah jam dalam rentang waktu. Nilai defaultnya adalah 0.

Properti parameter

Jenis:Int32
Nilai default:None
Mendukung wildcard:False
DontShow:False

Kumpulan parameter

Time
Position:Named
Wajib:False
Nilai dari alur:False
Nilai dari alur berdasarkan nama properti:False
Nilai dari argumen yang tersisa:False

-Milliseconds

Menentukan panjang rentang waktu dalam milidetik. Nilai defaultnya adalah 0.

Properti parameter

Jenis:Int32
Nilai default:None
Mendukung wildcard:False
DontShow:False

Kumpulan parameter

Time
Position:Named
Wajib:False
Nilai dari alur:False
Nilai dari alur berdasarkan nama properti:False
Nilai dari argumen yang tersisa:False

-Minutes

Menentukan menit dalam rentang waktu. Nilai defaultnya adalah 0.

Properti parameter

Jenis:Int32
Nilai default:None
Mendukung wildcard:False
DontShow:False

Kumpulan parameter

Time
Position:Named
Wajib:False
Nilai dari alur:False
Nilai dari alur berdasarkan nama properti:False
Nilai dari argumen yang tersisa:False

-Seconds

Menentukan panjang rentang waktu dalam detik. Nilai defaultnya adalah 0.

Properti parameter

Jenis:Int32
Nilai default:None
Mendukung wildcard:False
DontShow:False

Kumpulan parameter

Time
Position:Named
Wajib:False
Nilai dari alur:False
Nilai dari alur berdasarkan nama properti:False
Nilai dari argumen yang tersisa:False

-Start

Menentukan awal rentang waktu. Masukkan string yang menunjukkan tanggal dan waktu, seperti "15/3/09" atau objek DateTime , seperti dari perintah . Nilai defaultnya adalah tanggal dan waktu saat ini.

Anda dapat menggunakan Start atau aliasnya, LastWriteTime. Alias LastWriteTime memungkinkan Anda menyalurkan objek yang memiliki properti LastWriteTime, seperti file dalam sistem file ([IO.FileInfo]), ke parameter MulaiNew-TimeSpan.

Properti parameter

Jenis:DateTime
Nilai default:Current date and time
Mendukung wildcard:False
DontShow:False
Alias:WaktuPenulisanTerakhir

Kumpulan parameter

Date
Position:0
Wajib:False
Nilai dari alur:True
Nilai dari alur berdasarkan nama properti:True
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 objek DateTime yang mewakili waktu mulai ke cmdlet ini.

Output

TimeSpan

Cmdlet ini mengembalikan objek yang mewakili rentang waktu.