New-TimeSpan

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

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

De cmdlet New-TimeSpan maakt een TimeSpan--object dat een tijdsinterval vertegenwoordigt. U kunt een TimeSpan-object gebruiken om tijd op tetellen of af te trekken van DateTime--objecten.

Zonder parameters retourneert een New-TimeSpan opdracht een TimeSpan--object dat een tijdsinterval van nul vertegenwoordigt.

Met deze opdracht maakt u een TimeSpan-object met een duur van 1 uur en 25 minuten en slaat u het op in een variabele met de naam $TimeSpan. Er wordt een weergave weergegeven van het TimeSpan--object.

$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

In dit voorbeeld wordt een nieuw TimeSpan--object gemaakt dat het interval aangeeft 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)

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

Met deze opdrachten wordt de datum geretourneerd die 90 dagen na de huidige datum valt.

Met deze opdracht wordt aangegeven hoe lang het duurt sinds het about_Remote Help-bestand voor het laatst is bijgewerkt. U kunt deze opdrachtindeling gebruiken voor elk bestand of een ander object met een eigenschap LastWriteTime.

Deze opdracht werkt omdat de parameter Start van New-TimeSpan een alias van LastWriteTimeheeft. 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

Deze cmdlet ondersteunt de algemene parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction en -WarningVariable. Zie about_CommonParametersvoor meer informatie.

U kunt een DateTime--object doorsluisen dat de begintijd aan deze cmdlet aangeeft.

Met deze cmdlet wordt een object geretourneerd dat de tijdsduur aangeeft.