New-TimeSpan

  • Başvuru
Modül:
Microsoft.PowerShell.Utility

Bir TimeSpan nesnesi oluşturur.

Sözdizimi

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

Description

Cmdlet, New-TimeSpan zaman aralığını temsil eden bir TimeSpan nesnesi oluşturur. TimeTime nesnelerinden saat eklemek veya çıkarmak için Bir TimeSpan nesnesi kullanabilirsiniz.

Parametreler olmadan, komut New-TimeSpan sıfır zaman aralığını temsil eden bir TimeSpan nesnesi döndürür.

Örnekler

Örnek 1: Belirtilen süre için Bir TimeSpan nesnesi oluşturma

Bu komut, süresi 1 saat 25 dakika olan bir TimeSpan nesnesi oluşturur ve adlı bir değişkende $TimeSpandepolar. TimeSpan nesnesinin bir gösterimini görüntüler.

$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

Örnek 2: Zaman aralığı için TimeSpan nesnesi oluşturma

Bu örnek, komutun çalıştırıldığını saat ile 1 Ocak 2010 arasındaki aralığı temsil eden yeni bir TimeSpan nesnesi oluşturur.

Start parametresinin varsayılan değeri geçerli tarih ve saat olduğundan bu komut Start parametresini gerektirmez.

New-TimeSpan -End (Get-Date -Year 2010 -Month 1 -Day 1)

Örnek 3: Geçerli tarihten 90 gün sonrasını alma

$90days = New-TimeSpan -Days 90
(Get-Date) + $90days

Bu komutlar geçerli tarihten 90 gün sonraki tarihi döndürür.

Örnek 4: Bir dosya güncelleştirildiğinden bu yana TimeSpan'i bulma

Bu komut, about_remote yardım dosyasının son güncelleştirildiğinden bu yana ne kadar zaman geçtiğini bildirir. Bu komut biçimini herhangi bir dosyada veya LastWriteTime özelliğine sahip başka bir nesnede kullanabilirsiniz.

Start parametresi New-TimeSpan lastWriteTime diğer adına sahip olduğundan bu komut çalışır. LastWriteTime özelliğine sahip bir nesneyi öğesine New-TimeSpanaktardığınızda PowerShell, Start parametresinin değeri olarak LastWriteTime özelliğinin değerini kullanır.

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

Parametreler

-Days

Zaman aralığındaki günleri belirtir. Varsayılan değer 0'tir.

Tür:Int32
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-End

Bir zaman aralığının sonunu belirtir. Varsayılan değer geçerli tarih ve saattir.

Tür:DateTime
Position:1
Default value:Current date and time
Gerekli:False
İşlem hattı girişini kabul et:True
Joker karakterleri kabul et:False

-Hours

Zaman aralığındaki saatleri belirtir. Varsayılan değer 0'tir.

Tür:Int32
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-Milliseconds

Zaman aralığının uzunluğunu milisaniye cinsinden belirtir. Varsayılan değer 0'tir.

Tür:Int32
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-Minutes

Zaman aralığındaki dakikaları belirtir. Varsayılan değer 0'tir.

Tür:Int32
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-Seconds

Zaman aralığının uzunluğunu saniye cinsinden belirtir. Varsayılan değer 0'tir.

Tür:Int32
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-Start

Bir zaman aralığının başlangıcını belirtir. "15/3/09" gibi tarih ve saati temsil eden bir dize veya bir komuttan gelen bir nesne gibi bir Get-Date DateTime nesnesi girin. Varsayılan değer geçerli tarih ve saattir.

Başlat'ı veya diğer adı LastWriteTime'ı kullanabilirsiniz. LastWriteTime diğer adı, dosya sistemindeki [System.Io.FileIO]dosyalar gibi LastWriteTime özelliğine sahip nesneleri başlangıç parametresine New-TimeSpanyöneltmenizi sağlar.

Tür:DateTime
Diğer adlar:LastWriteTime
Position:0
Default value:Current date and time
Gerekli:False
İşlem hattı girişini kabul et:True
Joker karakterleri kabul et:False

Girişler

DateTime

Başlangıç saatini temsil eden bir DateTime nesnesini bu cmdlet'e yöneltebilirsiniz.

Çıkışlar

TimeSpan

Bu cmdlet, zaman aralığını temsil eden bir nesne döndürür.