Udostępnij za pośrednictwem

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>]
   [<CommonParameters>]

Opis

Polecenie New-TimeSpan cmdlet tworzy obiekt TimeSpan , który reprezentuje interwał 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 interwał czasu zera.

Przykłady

Przykład 1: Twórca obiektu TimeSpan przez określony czas trwania

To polecenie tworzy obiekt TimeSpan o długości 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: Twórca obiektu TimeSpan dla interwału czasu

W tym przykładzie zostanie utworzony nowy obiekt TimeSpan , który reprezentuje interwał między czasem uruchomienia polecenia a 1 stycznia 2010 r.

To polecenie nie wymaga parametru Start , ponieważ domyślną wartością parametru Start jest 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 . Ten format polecenia można użyć 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-TimeSpanprogramu , 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 zero.

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 potokować obiekt DateTime , który reprezentuje ten czas rozpoczęcia do New-TimeSpan.

Dane wyjściowe

TimeSpan

New-TimeSpan zwraca obiekt reprezentujący przedział czasu.