Megosztás a következőn keresztül:

New-TimeSpan

Modul:
Microsoft.PowerShell.Utility Module

Létrehoz egy TimeSpan objektumot.

Syntax

Date (Alapértelmezett) 

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

Time 

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. Egy TimeSpan objektummal időt vehet fel vagy vonhat ki 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 $TimeSpannevű vá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 utolsó frissítése. Ezt a parancsformátumot bármely fájlon vagy bármely más objektumon használhatja, amely rendelkezik LastWriteTime tulajdonságmal.

Ez a parancs azért működik, mert a New-TimeSpan paramétere LastWriteTimealiasával rendelkezik. Ha LastWriteTime tulajdonságot tartalmazó objektumot New-TimeSpan, 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.

Paramétertulajdonságok

Típus:Int32
Alapértelmezett érték:None
Támogatja a helyettesítő karaktereket:False
DontShow:False

Paraméterkészletek

Time
Position:Named
Kötelező:False
Folyamatból származó érték:False
Folyamatból származó érték tulajdonságnév alapján:False
Fennmaradó argumentumokból származó érték:False

-End

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

Paramétertulajdonságok

Típus:DateTime
Alapértelmezett érték:Current date and time
Támogatja a helyettesítő karaktereket:False
DontShow:False

Paraméterkészletek

Date
Position:1
Kötelező:False
Folyamatból származó érték:False
Folyamatból származó érték tulajdonságnév alapján:True
Fennmaradó argumentumokból származó érték:False

-Hours

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

Paramétertulajdonságok

Típus:Int32
Alapértelmezett érték:None
Támogatja a helyettesítő karaktereket:False
DontShow:False

Paraméterkészletek

Time
Position:Named
Kötelező:False
Folyamatból származó érték:False
Folyamatból származó érték tulajdonságnév alapján:False
Fennmaradó argumentumokból származó érték:False

-Minutes

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

Paramétertulajdonságok

Típus:Int32
Alapértelmezett érték:None
Támogatja a helyettesítő karaktereket:False
DontShow:False

Paraméterkészletek

Time
Position:Named
Kötelező:False
Folyamatból származó érték:False
Folyamatból származó érték tulajdonságnév alapján:False
Fennmaradó argumentumokból származó érték:False

-Seconds

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

Paramétertulajdonságok

Típus:Int32
Alapértelmezett érték:None
Támogatja a helyettesítő karaktereket:False
DontShow:False

Paraméterkészletek

Time
Position:Named
Kötelező:False
Folyamatból származó érték:False
Folyamatból származó érték tulajdonságnév alapján:False
Fennmaradó argumentumokból származó érték: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 Start vagy annak aliasát, LastWriteTime. Az LastWriteTime alias lehetővé teszi, hogy a LastWriteTime tulajdonságú objektumokat , például a fájlrendszerben lévő fájlokat [System.Io.FileIO], a indítása paraméterre csövezhesse New-TimeSpan.

Paramétertulajdonságok

Típus:DateTime
Alapértelmezett érték:Current date and time
Támogatja a helyettesítő karaktereket:False
DontShow:False
Aliasok:Utolsó módosítás ideje

Paraméterkészletek

Date
Position:0
Kötelező:False
Folyamatból származó érték:True
Folyamatból származó érték tulajdonságnév alapján:True
Fennmaradó argumentumokból származó érték:False

CommonParameters

Ez a parancsmag a következő gyakori paramétereket támogatja: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction és -WarningVariable. További információért lásd about_CommonParameters.

Bevitelek

DateTime

Egy DateTime objektumot csövezhet, amely az adott kezdési időpontot jelöli a New-TimeSpan.

Kimenetek

TimeSpan

New-TimeSpan az időtartományt jelképező objektumot ad vissza.