Dela via


New-TimeSpan

Skapar ett TimeSpan-objekt.

Syntax

New-TimeSpan
   [[-Start] <DateTime>]
   [[-End] <DateTime>]
   [<CommonParameters>]
New-TimeSpan
   [-Days <Int32>]
   [-Hours <Int32>]
   [-Minutes <Int32>]
   [-Seconds <Int32>]
   [-Milliseconds <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 TimeSpan-objektet.

$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 startparametern eftersom standardvärdet för startparametern ä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 en LastWriteTime-egenskap .

Det här kommandot fungerar eftersom startparametern New-TimeSpan för har aliaset LastWriteTime. När du rör ett objekt som har en LastWriteTime-egenskap 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

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 0.

Typ:Int32
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Milliseconds

Anger längden på tidsintervallet i millisekunder. Standardvärdet är 0.

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 en LastWriteTime-egenskap , 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

DateTime

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

Utdata

TimeSpan

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