New-TimeSpan

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

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

Cmdleten New-TimeSpan skapar ett TimeSpan- objekt som representerar ett tidsintervall. Du kan använda ett TimeSpan--objekt för att lägga till eller subtrahera tid från DateTime- objekt.

Utan parametrar returnerar ett New-TimeSpan-kommando ett TimeSpan- objekt som representerar ett tidsintervall på noll.

Det här kommandot skapar ett TimeSpan- objekt med en varaktighet på 1 timme och 25 minuter och lagrar det i en variabel med namnet $TimeSpan. Den visar en representation av objektet 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

I det här exemplet skapas ett nytt TimeSpan- objekt som representerar intervallet mellan den tid då kommandot körs och den 1 januari 2010.

Det här kommandot kräver inte parametern Start eftersom standardvärdet för parametern Start är aktuellt datum och tid.

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

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

Dessa kommandon returnerar det datum som är 90 dagar efter det aktuella datumet.

Det här kommandot anger hur lång tid det har gått sedan about_Remote hjälpfilen senast uppdaterades. Du kan använda det här kommandoformatet på valfri fil eller något annat objekt som har egenskapen LastWriteTime.

Det här kommandot fungerar eftersom parametern Start för New-TimeSpan har ett alias för LastWriteTime. När du rör ett objekt som har egenskapen LastWriteTime till New-TimeSpananvänder PowerShell värdet för egenskapen LastWriteTime som värdet för parametern 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

Den här cmdleten stöder vanliga parametrar: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction och -WarningVariable. Mer information finns i about_CommonParameters.

Du kan skicka ett DateTime- objekt som representerar starttiden för den här cmdleten.

Den här cmdleten returnerar ett objekt som representerar tidsintervallet.