New-TimeSpan

  • Referencia
Modul:
Microsoft.PowerShell.Utility

Létrehoz egy TimeSpan objektumot.

Syntax

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

Description

A New-TimeSpan parancsmag létrehoz egy TimeSpan objektumot, amely egy időintervallumot jelöl. TimeSpan objektummal időt adhat hozzá vagy vonhat ki a DateTime-objektumokból.

Paraméterek nélkül a New-TimeSpan parancs egy TimeSpan objektumot ad vissza, amely nulla időintervallumot jelöl.

Példák

1. példa: TimeSpan-objektum létrehozása megadott időtartamra

Ez a parancs létrehoz egy TimeSpan objektumot 1 óra 25 perces időtartammal, és egy nevű $TimeSpanváltozóban tárolja. Megjeleníti a TimeSpan objektumot.

$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

2. példa: TimeSpan-objektum létrehozása egy időintervallumhoz

Ez a példa létrehoz egy új TimeSpan objektumot, amely a parancs futtatása és 2010. január 1. közötti időközt jelöli.

Ehhez a parancshoz nincs szükség a Start paraméterre, mert a Start paraméter alapértelmezett értéke az aktuális dátum és idő.

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

3. példa: Az aktuális dátumtól számított 90 napos dátum lekérése

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

Ezek a parancsok az aktuális dátumot követő 90 napos dátumot adják vissza.

4. példa: A TimeSpan felderítése a fájl frissítése óta

Ez a parancs bemutatja, hogy mennyi ideig tartott a about_remote súgófájl legutóbbi frissítése. Ezt a parancsformátumot bármely fájlon vagy bármely más, LastWriteTime tulajdonságú objektumon használhatja.

Ez a parancs azért működik, mert a Start paraméter New-TimeSpan a LastWriteTime aliasával rendelkezik. Ha egy LastWriteTime tulajdonságú New-TimeSpanobjektumot ad meg, a PowerShell a LastWriteTime tulajdonság értékét használja a Start paraméter értékeként.

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

Paraméterek

-Days

Az időtartam napjait adja meg. Az alapértelmezett érték 0.

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-End

Egy időtartam végét adja meg. Az alapértelmezett érték az aktuális dátum és idő.

Type:DateTime
Position:1
Default value:Current date and time
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Hours

Az időtartamban megadott órákat adja meg. Az alapértelmezett érték nulla.

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Minutes

Az időtartományban lévő perceket adja meg. Az alapértelmezett érték 0.

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Seconds

Az időtartam hosszát adja meg másodpercben. Az alapértelmezett érték 0.

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Start

Egy időtartam kezdetét adja meg. Adjon meg egy olyan sztringet, amely a dátumot és az időt jelöli, például a "3/15/09" vagy egy DateTime objektumot, például egy Get-Date parancsból. Az alapértelmezett érték az aktuális dátum és idő.

Használhatja a Start vagy annak aliasát, a LastWriteTime-ot. A LastWriteTime alias lehetővé teszi, hogy a LastWriteTime tulajdonságú objektumokat, például a fájlrendszerben [System.Io.FileIO]lévő fájlokat a rendszer Start paraméteréhez New-TimeSpancsövezhesse.

Type:DateTime
Aliases:LastWriteTime
Position:0
Default value:Current date and time
Required:False
Accept pipeline input:True
Accept wildcard characters:False

Bevitelek

DateTime

Ehhez a parancsmaghoz a kezdési időpontot jelképező DateTime objektumot csövezheti.

Kimenetek

TimeSpan

Ez a parancsmag az időtartományt képviselő objektumot adja vissza.