New-TimeSpan

  • Referentie
Module:
Microsoft.PowerShell.Utility

Hiermee maakt u een TimeSpan-object.

Syntax

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

Description

De New-TimeSpan cmdlet 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 aangeeft.

Voorbeelden

Voorbeeld 1: Een TimeSpan-object maken voor een opgegeven duur

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 van het TimeSpan-object 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 maken voor een tijdsinterval

In dit voorbeeld wordt een nieuw TimeSpan-object gemaakt dat het interval aangeeft tussen de tijd dat de opdracht wordt uitgevoerd en 1 januari 2010.

Voor deze opdracht is geen startparameter 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 90 dagen ophalen vanaf de huidige datum

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

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

Voorbeeld 4: Ontdek de tijdspan sinds een bestand is bijgewerkt

Met deze opdracht wordt aangegeven hoe lang het is 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 startparameter New-TimeSpan een alias van LastWriteTime heeft. Wanneer u een object met een eigenschap LastWriteTime doorsluist naarNew-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 periode. 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 tijdsduur. 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 periode. De standaardwaarde is nul.

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 tijdsduur. 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 lengte van de tijdsduur in seconden. 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 tijdsduur. 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 een eigenschap LastWriteTime , zoals bestanden in het bestandssysteem [System.Io.FileIO], doorsluisen naar de startparameter 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

DateTime

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

Uitvoerwaarden

TimeSpan

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