New-TimeSpan
Skapar ett TimeSpan-objekt.
Syntax
New-TimeSpan
[[-Start] <DateTime>]
[[-End] <DateTime>]
[<CommonParameters>]
New-TimeSpan
[-Days <Int32>]
[-Hours <Int32>]
[-Minutes <Int32>]
[-Seconds <Int32>]
[<CommonParameters>]
Description
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.
Exempel
Exempel 1: Skapa ett TimeSpan-objekt under en angiven varaktighet
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
Exempel 2: Skapa ett TimeSpan-objekt för ett tidsintervall
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)
Exempel 3: Hämta datumet 90 dagar från det aktuella datumet
$90days = New-TimeSpan -Days 90
(Get-Date) + $90days
Dessa kommandon returnerar det datum som är 90 dagar efter det aktuella datumet.
Exempel 4: Identifiera TimeSpan sedan en fil uppdaterades
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-TimeSpan
anvä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
Parametrar
-Days
Anger dagar i tidsintervallet. Standardvärdet är 0.
Typ: | Int32 |
Position: | Named |
Standardvärde: | None |
Obligatorisk: | False |
Godkänn pipeline-indata: | False |
Godkänn jokertecken: | False |
-End
Anger slutet på ett tidsintervall. Standardvärdet är aktuellt datum och tid.
Typ: | DateTime |
Position: | 1 |
Standardvärde: | Current date and time |
Obligatorisk: | False |
Godkänn pipeline-indata: | True |
Godkänn jokertecken: | False |
-Hours
Anger timmarna i tidsintervallet. Standardvärdet är noll.
Typ: | Int32 |
Position: | Named |
Standardvärde: | None |
Obligatorisk: | False |
Godkänn pipeline-indata: | False |
Godkänn jokertecken: | False |
-Minutes
Anger minuter i tidsintervallet. Standardvärdet är 0.
Typ: | Int32 |
Position: | Named |
Standardvärde: | None |
Obligatorisk: | False |
Godkänn pipeline-indata: | False |
Godkänn jokertecken: | False |
-Seconds
Anger längden på tidsintervallet i sekunder. Standardvärdet är 0.
Typ: | Int32 |
Position: | Named |
Standardvärde: | None |
Obligatorisk: | False |
Godkänn pipeline-indata: | False |
Godkänn jokertecken: | False |
-Start
Anger början på ett tidsintervall.
Ange en sträng som representerar datum och tid, till exempel "3/15/09" eller ett DateTime-objekt, till exempel ett från ett Get-Date
kommando. Standardvärdet är aktuellt datum och tid.
Du kan använda Start eller dess alias, LastWriteTime.
Med aliaset LastWriteTime kan du skicka objekt som har egenskapen LastWriteTime, till exempel filer i filsystemet [System.Io.FileIO]
, till parametern Start för New-TimeSpan
.
Typ: | DateTime |
Alias: | LastWriteTime |
Position: | 0 |
Standardvärde: | Current date and time |
Obligatorisk: | False |
Godkänn pipeline-indata: | True |
Godkänn jokertecken: | False |
Indata
Du kan skicka ett DateTime- objekt som representerar starttiden för att New-TimeSpan
.
Utdata
New-TimeSpan
returnerar ett objekt som representerar tidsintervallet.