New-TimeSpan

  • Odwołanie
Moduł:
Microsoft.PowerShell.Utility

Tworzy obiekt TimeSpan.

Składnia

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

Opis

Polecenie New-TimeSpan cmdlet tworzy obiekt TimeSpan , który reprezentuje przedział czasu. Możesz użyć obiektu TimeSpan, aby dodać lub odjąć godzinę z obiektów DateTime.

Bez parametrów New-TimeSpan polecenie zwraca obiekt TimeSpan , który reprezentuje przedział czasu równy zero.

Przykłady

Przykład 1. Tworzenie obiektu TimeSpan dla określonego czasu trwania

To polecenie tworzy obiekt TimeSpan o czasie trwania 1 godziny i 25 minut i zapisuje go w zmiennej o nazwie $TimeSpan. Wyświetla reprezentację obiektu 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

Przykład 2. Tworzenie obiektu TimeSpan dla interwału czasu

W tym przykładzie zostanie utworzony nowy obiekt TimeSpan reprezentujący interwał między czasem uruchomienia polecenia a 1 stycznia 2010 r.

To polecenie nie wymaga parametru Start, ponieważ domyślna wartość parametru Start to bieżąca data i godzina.

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

Przykład 3. Pobieranie daty 90 dni od bieżącej daty

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

Te polecenia zwracają datę 90 dni po bieżącej dacie.

Przykład 4. Odnajdywanie przedziału czasu od czasu zaktualizowania pliku

To polecenie informuje, jak długo minęło od czasu ostatniej aktualizacji pliku pomocy about_remote . Możesz użyć tego formatu polecenia w dowolnym pliku lub innym obiekcie, który ma właściwość LastWriteTime .

To polecenie działa, ponieważ parametr Start polecenia New-TimeSpan ma alias LastWriteTime. Podczas potoku obiektu, który ma właściwość LastWriteTime do New-TimeSpan, program PowerShell używa wartości właściwości LastWriteTime jako wartości parametru Start.

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

Parametry

-Days

Określa dni w przedziale czasu. Wartość domyślna to 0.

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-End

Określa koniec przedziału czasu. Wartość domyślna to bieżąca data i godzina.

Type:DateTime
Position:1
Default value:Current date and time
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Hours

Określa godziny w przedziale czasu. Wartość domyślna to 0.

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Milliseconds

Określa długość przedziału czasu w milisekundach. Wartość domyślna to 0.

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Minutes

Określa minuty w przedziale czasu. Wartość domyślna to 0.

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Seconds

Określa długość przedziału czasu w sekundach. Wartość domyślna to 0.

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Start

Określa początek przedziału czasu. Wprowadź ciąg reprezentujący datę i godzinę, taki jak "3/15/09" lub obiekt DateTime , taki jak jeden z Get-Date polecenia. Wartość domyślna to bieżąca data i godzina.

Możesz użyć polecenia Start lub jego aliasu LastWriteTime. Alias LastWriteTime umożliwia potokowanie obiektów, które mają właściwość LastWriteTime, taką jak pliki w systemie [System.Io.FileIO]plików , do parametru Start .New-TimeSpan

Type:DateTime
Aliases:LastWriteTime
Position:0
Default value:Current date and time
Required:False
Accept pipeline input:True
Accept wildcard characters:False

Dane wejściowe

DateTime

Możesz przekazać potok obiektu DateTime reprezentującego godzinę rozpoczęcia do tego polecenia cmdlet.

Dane wyjściowe

TimeSpan

To polecenie cmdlet zwraca obiekt reprezentujący przedział czasu.