Sdílet prostřednictvím

New-TimeSpan

  • Reference
Modul:
Microsoft.PowerShell.Utility

Vytvoří objekt TimeSpan.

Syntaxe

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

Description

Rutina New-TimeSpan vytvoří objekt TimeSpan, který představuje časový interval. Pomocí objektu TimeSpan můžete sčítat nebo odečítat čas od objektů DateTime.

Bez parametrů vrátí New-TimeSpan příkaz TimeSpan objekt, který představuje časový interval nuly.

Příklady

Příklad 1: Vytvoření objektu TimeSpan pro zadanou dobu trvání

Tento příkaz vytvoří objekt TimeSpan s dobou trvání 1 hodiny a 25 minut a uloží ho do proměnné s názvem $TimeSpan. Zobrazí reprezentaci objektu 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

Příklad 2: Vytvoření objektu TimeSpan pro časový interval

Tento příklad vytvoří nový TimeSpan objekt, který představuje interval mezi časem spuštění příkazu a 1. ledna 2010.

Tento příkaz nevyžaduje parametr Start, protože výchozí hodnota parametru Start je aktuální datum a čas.

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

Příklad 3: Získání data 90 dnů od aktuálního data

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

Tyto příkazy vrátí datum, které je 90 dní po aktuálním datu.

Příklad 4: Zjištění časového rozsahu od aktualizace souboru

Tento příkaz vám řekne, jak dlouho byl od poslední aktualizace souboru nápovědy about_remote. Tento formát příkazu můžete použít pro libovolný soubor nebo jakýkoli jiný objekt, který má vlastnost LastWriteTime.

Tento příkaz funguje, protože parametr StartNew-TimeSpan má alias LastWriteTime. Když předáte objekt, který má LastWriteTime vlastnost New-TimeSpan, PowerShell použije hodnotu LastWriteTime vlastnost jako hodnotu parametru 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

Parametry

-Days

Určuje dny v časovém rozsahu. Výchozí hodnota je 0.

Typ:Int32
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-End

Určuje konec časového rozsahu. Výchozí hodnota je aktuální datum a čas.

Typ:DateTime
Position:1
Default value:Current date and time
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-Hours

Určuje hodiny v časovém rozsahu. Výchozí hodnota je nula.

Typ:Int32
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Minutes

Určuje minuty v časovém rozsahu. Výchozí hodnota je 0.

Typ:Int32
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Seconds

Určuje délku časového rozsahu v sekundách. Výchozí hodnota je 0.

Typ:Int32
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Start

Určuje začátek časového rozsahu. Zadejte řetězec, který představuje datum a čas, například 3/15/09 nebo objekt DateTime, například objekt z příkazu Get-Date. Výchozí hodnota je aktuální datum a čas.

Můžete použít Start nebo jeho alias, LastWriteTime. Alias LastWriteTime umožňuje pipetovat objekty, které mají vlastnost LastWriteTime, například soubory v systému souborů [System.Io.FileIO], do parametru StartNew-TimeSpan.

Typ:DateTime
Aliasy:LastWriteTime
Position:0
Default value:Current date and time
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

Vstupy

DateTime

Objekt DateTime, který představuje počáteční čas New-TimeSpan.

Výstupy

TimeSpan

New-TimeSpan vrátí objekt, který představuje časové rozpětí.