New-TimeSpan
Hiermee maakt u een TimeSpan-object.
Syntax
New-TimeSpan
[[-Start] <DateTime>]
[[-End] <DateTime>]
[<CommonParameters>]
New-TimeSpan
[-Days <Int32>]
[-Hours <Int32>]
[-Minutes <Int32>]
[-Seconds <Int32>]
[-Milliseconds <Int32>]
[<CommonParameters>]
Description
De New-TimeSpan
cmdlet maakt een TimeSpan-object dat een tijdsinterval vertegenwoordigt.
U kunt een TimeSpan-object gebruiken om tijd toe te voegen aan of af te trekken van DateTime-objecten .
Zonder parameters retourneert een New-TimeSpan
opdracht een TimeSpan-object dat een tijdsinterval van nul vertegenwoordigt.
Voorbeelden
Voorbeeld 1: een TimeSpan-object Creatie voor een opgegeven duur
Met deze opdracht maakt u een TimeSpan-object met een duur van 1 uur en 25 minuten en slaat u dit op in een variabele met de naam $TimeSpan
. Er wordt een weergave van het Object TimeSpan weergegeven.
$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
Voorbeeld 2: een TimeSpan-object Creatie voor een tijdsinterval
In dit voorbeeld wordt een nieuw TimeSpan-object gemaakt dat het interval vertegenwoordigt tussen het tijdstip waarop de opdracht wordt uitgevoerd en 1 januari 2010.
Voor deze opdracht is de parameter Start niet vereist, omdat de standaardwaarde van de parameter Start de huidige datum en tijd is.
New-TimeSpan -End (Get-Date -Year 2010 -Month 1 -Day 1)
Voorbeeld 3: De datum ophalen 90 dagen na de huidige datum
$90days = New-TimeSpan -Days 90
(Get-Date) + $90days
Deze opdrachten retourneren de datum die 90 dagen na de huidige datum valt.
Voorbeeld 4: De Tijdspan detecteren sinds een bestand is bijgewerkt
Met deze opdracht wordt aangegeven hoe lang het geleden is dat het about_remote Help-bestand voor het laatst is bijgewerkt. U kunt deze opdrachtindeling gebruiken voor elk bestand of elk ander object met de eigenschap LastWriteTime .
Deze opdracht werkt omdat de parameter Start van New-TimeSpan
de alias LastWriteTime heeft. Wanneer u een object met een eigenschap LastWriteTime doorsluist naar New-TimeSpan
, gebruikt PowerShell de waarde van de eigenschap LastWriteTime als de waarde van de parameter 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
Parameters
-Days
Hiermee geeft u de dagen in de tijdsperiode. De standaardwaarde is 0.
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-End
Hiermee geeft u het einde van een periode op. De standaardwaarde is de huidige datum en tijd.
Type: | DateTime |
Position: | 1 |
Default value: | Current date and time |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Hours
Hiermee geeft u de uren in de tijdsperiode. De standaardwaarde is 0.
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Milliseconds
Hiermee geeft u de lengte van de periode in milliseconden. De standaardwaarde is 0.
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Minutes
Hiermee geeft u de minuten in de tijdsperiode. De standaardwaarde is 0.
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Seconds
Hiermee geeft u de duur van de tijdsduur in seconden op. De standaardwaarde is 0.
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Start
Hiermee geeft u het begin van een tijdsperiode. Voer een tekenreeks in die de datum en tijd vertegenwoordigt, zoals '15-3-09' of een DateTime-object , zoals een van een Get-Date
opdracht. De standaardwaarde is de huidige datum en tijd.
U kunt Start of de bijbehorende alias LastWriteTime gebruiken. Met de alias LastWriteTime kunt u objecten met de eigenschap LastWriteTime , zoals bestanden in het bestandssysteem [System.Io.FileIO]
, doorspeuren naar de parameter Start van New-TimeSpan
.
Type: | DateTime |
Aliases: | LastWriteTime |
Position: | 0 |
Default value: | Current date and time |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
Invoerwaarden
U kunt een DateTime-object dat de begintijd vertegenwoordigt, doorspeuren naar deze cmdlet.
Uitvoerwaarden
Deze cmdlet retourneert een object dat de tijdsperiode vertegenwoordigt.