Get-Date

Modul:: Microsoft.PowerShell.Utility Module

Lekéri az aktuális dátumot és időpontot.

Syntax

net (Alapértelmezett)

Get-Date
    [[-Date] <DateTime>]
    [-Year <Int32>]
    [-Month <Int32>]
    [-Day <Int32>]
    [-Hour <Int32>]
    [-Minute <Int32>]
    [-Second <Int32>]
    [-Millisecond <Int32>]
    [-DisplayHint <DisplayHintType>]
    [-Format <String>]
    [<CommonParameters>]

UFormat

Get-Date
    [[-Date] <DateTime>]
    [-Year <Int32>]
    [-Month <Int32>]
    [-Day <Int32>]
    [-Hour <Int32>]
    [-Minute <Int32>]
    [-Second <Int32>]
    [-Millisecond <Int32>]
    [-DisplayHint <DisplayHintType>]
    [-UFormat <String>]
    [<CommonParameters>]

Description

A Get-Date parancsmag egy DateTime objektumot kap, amely az aktuális dátumot vagy a megadott dátumot jelöli. Get-Date több .NET- és Unix-formátumban is formázhatja a dátumot és az időt. A Get-Date használatával dátum- vagy idő karaktersorozatot hozhat létre, majd elküldheti a sztringet más parancsmagoknak vagy programoknak.

Get-Date az operációs rendszer aktuális kulturális beállításait használja a kimenet formázásának meghatározásához. A számítógép beállításainak megtekintéséhez használja a (Get-Culture).DateTimeFormat.

Példák

1. példa: Az aktuális dátum és idő lekérése

Ebben a példában Get-Date az aktuális rendszerdátumot és időpontot jeleníti meg. A kimenet hosszú dátumú és hosszú idejű formátumban jelenik meg.

Get-Date

Tuesday, June 25, 2019 14:53:32

2. példa: Az aktuális dátum és idő elemeinek lekérése

Ez a példa bemutatja, hogyan használható Get-Date a dátum- vagy időelem lekérésére. A paraméter a Date , Timevagy DateTimeargumentumokat használja.

Get-Date -DisplayHint Date

Tuesday, June 25, 2019

Get-Date a DisplayHint paramétert használja a Dátum argumentummal, hogy csak a dátumot kapja meg.

3. példa: A dátum és az idő lekérése .NET formátumjelölővel

Ebben a példában a kimenet formátumának testreszabásához .NET formátumjelölőt használunk. A kimenet egy sztring objektum.

Get-Date -Format "dddd MM/dd/yyyy HH:mm K"

Tuesday 06/25/2019 16:17 -07:00

Get-Date a Formátum paraméterrel több formátumjelölőt is megadhat.

A példában használt .NET formátumjelölők a következőképpen vannak definiálva:

Kijelölő	Definíció
`dddd`	A hét napja – teljes név
`MM`	Hónap száma
`dd`	A hónap napja – 2 számjegy
`yyyy`	Év 4 jegyű formátumban
`HH:mm`	Idő 24 órás formátumban – másodperc nélkül
`K`	Időzóna eltolása az egyetemes időkoordinátától (UTC)

A .NET formátumjelölőiről további információt Egyéni dátum- és időformátum-sztringekcímű témakörben talál.

4. példa: Dátum és idő lekérése egy UFormat-meghatározóval

Ebben a példában több UFormat formátumjelölőt használunk a kimenet formátumának testreszabásához. A kimenet egy sztring objektum.

Get-Date -UFormat "%A %m/%d/%Y %R %Z"

Tuesday 06/25/2019 16:19 -07

Get-Date a UFormat paraméterrel több formátumjelölőt is megadhat.

A példában használt UFormat formátumjelölők a következőképpen vannak definiálva:

Kijelölő	Definíció
`%A`	A hét napja – teljes név
`%m`	Hónap száma
`%d`	A hónap napja – 2 számjegy
`%Y`	Év 4 jegyű formátumban
`%R`	Idő 24 órás formátumban – másodperc nélkül
`%Z`	Időzóna eltolása az egyetemes időkoordinátától (UTC)

Az érvényes UFormat formátumjelölők listáját a Megjegyzések szakaszban találja.

5. példa: Az év dátumának lekérése

Ebben a példában egy tulajdonságot használunk az év numerikus napjának lekéréséhez.

A Gergely naptár 365 nap, kivéve szökőévek, amelyek 366 nap. 2020. december 31-e például a 366. nap.

(Get-Date -Year 2020 -Month 12 -Day 31).DayOfYear

Get-Date három paramétert használ a dátum megadásához: Év, Hónapés Nap. A parancs zárójelekbe van csomagolva, hogy az eredményt a DayOfYear tulajdonság értékelje ki.

6. példa: Ellenőrizze, hogy a nyári időszámításhoz igazított-e dátumot

Ez a példa logikai módszerrel ellenőrzi, hogy a dátumot a nyári időszámítás módosítja-e.

$DST = Get-Date
$DST.IsDaylightSavingTime()

True

Egy változó, $DST tárolja a Get-Dateeredményét. $DST a IsDaylightSavingTime metódussal ellenőrzi, hogy a dátum a nyári időszámításhoz van-e igazítva.

7. példa: Az aktuális idő konvertálása UTC-időpontra

Ebben a példában a rendszer az aktuális időt UTC-idővé alakítja. A rendszer területi beállításának UTC-eltolása az idő konvertálására szolgál. A Jegyzetek szakaszban található táblázat felsorolja az érvényes UFormat formátumjelölőket.

Get-Date -UFormat "%A %B/%d/%Y %T %Z"
$Time = Get-Date
$Time.ToUniversalTime()

Wednesday June/26/2019 10:45:26 -07

Wednesday, June 26, 2019 17:45:26

Get-Date a UFormat paramétert használja formátumjelölőkkel az aktuális rendszerdátum és idő megjelenítéséhez. A formátumjelölő %Z a -07UTC-eltolását jelöli.

A $Time változó az aktuális rendszerdátumot és időpontot tárolja. $Time a ToUniversalTime() metódussal konvertálja az időt a számítógép UTC-eltolása alapján.

8. példa: Időbélyeg létrehozása

Ebben a példában egy formátumkijelölő létrehoz egy időbélyeget Karakterlánc objektumot egy könyvtárnévhez. Az időbélyeg tartalmazza a dátum, az idő és az UTC eltolódását.

$timestamp = Get-Date -Format o | ForEach-Object { $_ -replace ":", "." }
New-Item -Path C:\Test\$timestamp -Type Directory

    Directory: C:\Test

Mode                LastWriteTime         Length Name
----                -------------         ------ ----
d-----         6/27/2019    07:59                2019-06-27T07.59.24.4603750-07.00

A $timestamp változó egy Get-Date parancs eredményeit tárolja. Get-Date a Formátum paramétert használja kisbetűs o formátumkijelölőjével egy időbélyeg Karakterlánc objektum létrehozásához. Az objektumot a rendszer a ForEach-Object-hoz továbbítja a folyamat során. A ScriptBlock az aktuális folyamatobjektumot képviselő $_ változót tartalmazza. Az időbélyeg-sztringet pontokkal helyettesített kettőspontokkal tagolja.

New-Item a Path paraméterrel adja meg egy új könyvtár helyét. Az elérési út könyvtárnévként tartalmazza a $timestamp változót. A Type paraméter azt határozza meg, hogy létrejön-e egy könyvtár.

9. példa: Invariáns kultúra megjelenítése

A ToString()DateTime objektumot konvertál Sztring az aktuális kulturális beállítással. A PowerShell-kifejezések értelmezése azonban mindig az invariáns kulturális beállítást használja.

Ha például a en-US kultúra van érvényben, a ToString() metódus a dátumot a en-US kulturális beállítások használatával formázhatja.

# Get date using current culture en-US
(Get-Date 2024-03-19).ToString()

3/19/2024 12:00:00 AM

# Get date using invariant culture
"$(Get-Date 2024-03-19)"

03/19/2024 00:00:00

Paraméterek

-Date

Dátumot és időt ad meg. Az idő megadása nem kötelező, és ha nincs megadva, 00:00:00 értéket ad vissza. Adja meg a dátumot és az időt az aktuálisan kiválasztott területi beállításhoz szokásos formátumban. Az aktuális területi beállításokat a Set-Culture parancsmaggal módosíthatja.

Például amerikai angol nyelven:

Get-Date -Date "6/25/2019 12:30:22" 2019. június 25., kedd 12:30:22

Paramétertulajdonságok

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

Paraméterkészletek

(All)

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

-Day

A megjelenő hónap napját adja meg. Adjon meg egy 1 és 31 közötti értéket.

Ha a megadott érték nagyobb, mint egy hónap napjainak száma, a PowerShell hozzáadja a napok számát a hónaphoz. A Get-Date -Month 4 -Day 31 például . május 1-jénjelenik meg , nem április 31-én.

Paramétertulajdonságok

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

Paraméterkészletek

(All)

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

-DisplayHint

Meghatározza, hogy a dátum és az idő mely elemei jelenjenek meg.

Az elfogadott értékek a következők:

Dátum: csak a dátumot jeleníti meg
idő: csak az időt jeleníti meg
DateTime: megjeleníti a dátumot és az időt

Paramétertulajdonságok

Típus:	DisplayHintType
Alapértelmezett érték:	None
Elfogadott értékek:	Date, Time, DateTime
Támogatja a helyettesítő karaktereket:	False
DontShow:	False

Paraméterkészletek

(All)

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

-Format

Megjeleníti a microsoft .NET-keretrendszer formátumában szereplő dátumot és időt, amelyet a formátumkijelölő jelez. A Format paraméter egy Karakterlánc objektumot ad ki.

Az elérhető .NET formátumjelölők listáját Egyéni dátum- és időformátum-sztringekcímű témakörben találja.

Ha a Format paramétert használja, Get-Date csak a dátum megjelenítéséhez szükséges DateTime objektum tulajdonságait kapja meg. Ennek eredményeképpen előfordulhat, hogy DateTime objektumok néhány tulajdonsága és metódusa nem érhető el.

A PowerShell 5.0-tól kezdve az alábbi további formátumokat használhatja a Formátum paraméter értékeiként.

FileDate. Az aktuális dátum fájl- vagy útvonalbarát ábrázolása helyi idő szerint. A formátum yyyyMMdd (a kis- és nagybetűk megkülönböztetése 4 jegyű év, kétjegyű hónap és kétjegyű nap használatával). Például: 20190627.
FileDateUniversal fájl. Az aktuális dátum fájl- vagy útvonalbarát ábrázolása az egyetemes időben (UTC). A formátum yyyyMMddZ (kis- és nagybetűk megkülönböztetése, 4 jegyű év, 2 jegyű hónap, 2 jegyű nap, és a betű Z AZ UTC jelző). Például: 20190627Z.
FileDateTime. Az aktuális dátum és idő fájl- vagy útvonalbarát ábrázolása helyi idő szerint, 24 órás formátumban. A formátum yyyyMMddTHHmmssffff (kis- és nagybetűk megkülönböztetése, 4 jegyű év, 2 jegyű hónap, kétjegyű nap, a betű T időelválasztóként, 2 jegyű óra, kétjegyű perc, kétjegyű másodperc és 4 számjegyű ezredmásodperc). Például: 20190627T0840107271.
FileDateTimeUniversal fájlt. Az aktuális dátum és idő fájl- vagy útvonalbarát ábrázolása az egyetemes időben (UTC) 24 órás formátumban. A formátum yyyyMMddTHHmmssffffZ (kis- és nagybetűk megkülönböztetése, 4 jegyű év, 2 jegyű hónap, kétjegyű nap, a betű T időelválasztóként, 2 jegyű óra, kétjegyű perc, kétjegyű másodperc, 4 jegyű ezredmásodperc, és a betű Z UTC-jelzőként). Például: 20190627T1540500718Z.

Paramétertulajdonságok

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

Paraméterkészletek

net

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

-Hour

A megjelenített órát adja meg. Adjon meg 0 és 23 közötti értéket.

Paramétertulajdonságok

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

Paraméterkészletek

(All)

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

-Millisecond

A dátum ezredmásodperceit adja meg. Adjon meg 0 és 999 közötti értéket.

Ezt a paramétert a PowerShell 3.0-ban vezettük be.

Paramétertulajdonságok

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

Paraméterkészletek

(All)

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

-Minute

Meghatározza a megjelenített perceket. Adjon meg 0 és 59 közötti értéket.

Paramétertulajdonságok

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

Paraméterkészletek

(All)

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

-Month

A megjelenő hónapot adja meg. Adjon meg egy 1 és 12 közötti értéket.

Paramétertulajdonságok

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

Paraméterkészletek

(All)

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

-Second

A megjelenített másodikat adja meg. Adjon meg 0 és 59 közötti értéket.

Paramétertulajdonságok

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

Paraméterkészletek

(All)

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

-UFormat

Unix formátumban jeleníti meg a dátumot és az időt. A UFormat paraméter egy sztringobjektumot ad ki.

UFormat-definiálókat százalékjel (%) előzi meg, például %m, %dés %Y. A Megjegyzések szakasz érvényes UFormat-azonosítóktáblázatát tartalmazza.

Paramétertulajdonságok

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

Paraméterkészletek

UFormat

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

-Year

A megjelenített évet adja meg. Adjon meg egy 1 és 9999 közötti értéket.

Paramétertulajdonságok

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

Paraméterkészletek

(All)

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

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

A parancsmaghoz DateTime objektumot csövezheti.

Kimenetek

DateTime

Ez a parancsmag alapértelmezés szerint egy DateTime objektumot ad vissza.

Ha egy DateTime objektumot küld le a folyamatból egy parancsmagba, például Add-Content, amely sztringbemenetet vár, a PowerShell átalakítja az objektumot egy Karakterlánc objektummá.

A ToString()DateTime objektumot alakít át Sztring az aktuális kulturális beállítással. A PowerShell-kifejezések értelmezése azonban mindig az invariáns kulturális beállítást használja. Az invariáns kultúra eltérőségéről 9. példa.

Egy objektum tulajdonságainak és metódusainak megjelenítéséhez küldje el az objektumot a folyamaton keresztül a Get-Member. Például: Get-Date | Get-Member.

String

A Formátum vagy UFormat paraméterek használatakor ez a parancsmag Karakterlánc objektumokat ad vissza.

Jegyzetek

Az DateTime objektumok kimenetének alapértelmezett formátumai a jelenleg kijelölt területi beállítás hosszú és hosszú idejű formátumai.

Az érvényes UFormat-azonosítók az alábbi táblázatban jelennek meg:

Fontos

UFormat-definiálók módosulnak vagy hozzáadódnak a PowerShell újabb verzióiban. Például %F a PowerShell 6.2-ben lett hozzáadva, így nem érhető el a Windows PowerShell 5.1-ben vagy régebbi verzióiban. Ezt tartsa szem előtt, ha UFormat-definiálókat használ a PowerShell több verzióján való futtatásra tervezett szkriptekben.

Formátumkijelölő	Értelmezés	példa
`%A`	A hét napja – teljes név	Monday
`%a`	A hét napja – rövidített név	Mon
`%B`	Hónap neve – teljes	Január
`%b`	Hónap neve – rövidítve	Jan
`%C`	Század	20 2019-ben
`%c`	Dátum és idő – rövidítve	Jún. 27. 08:44:18 2019
`%D`	Dátum mm/dd/ééé formátumban	06/27/19
`%d`	A hónap napja – 2 számjegy	05
`%e`	A hónap napja – szóközzel megelőzve, ha csak egy számjegy	<szóköz>5
`%G`	Ugyanaz, mint "Y"
`%g`	Ugyanaz, mint 'y'
`%H`	Óra 24 órás formátumban	17
`%h`	Ugyanaz, mint a "b"
`%I`	Óra 12 órás formátumban	05
`%j`	Az év napja (nem tartalmazza a vezető `0` – Javítva a PowerShell 6+-ban)	1-366
`%k`	Ugyanaz, mint a "H"
`%l`	Ugyanaz, mint az "I" (nagybetűs I)	05
`%M`	Percek	35
`%m`	Hónap száma	06
`%n`	újvonalas karakter
`%p`	AM vagy PM
`%R`	Idő 24 órás formátumban -no másodpercben	17:45
`%r`	Idő 12 órás formátumban	09:15:36
`%S`	Másodperc	05
`%s`	1970. január 1. óta eltelt másodpercek 00:00:00 (helyi idő szerint konvertálva)	1150451174.95705
`%t`	Vízszintes tabulátor karakter
`%T`	Idő 24 órás formátumban	17:45:52
`%U`	Ugyanaz, mint a "W"
`%u`	A hét napja – szám	Vasárnap = 0
`%V`	Az év hete	01-53
`%w`	Ugyanaz, mint az "u"
`%W`	Az év hete	1-53
`%X`	Ugyanaz, mint a "T"
`%x`	Dátum szabványos formátumban a területi beállításhoz	06/27/19 English-US
`%Y`	Év 4 jegyű formátumban	2019
`%y`	Év kétjegyű formátumban	19
`%Z`	Időzóna eltolása az egyetemes időkoordinátától (UTC)	-07

Megjegyzés:

A Windows PowerShell Get-Date -UFormat %s való viselkedése két szempontból helytelen:

A visszatérési érték az UTC idő helyett a helyi idő alapján történik.
A másodpercérték sztringképének törtrésze van. A kimenet a tizedesjel szempontjából kulturális szempontból érzékeny.

Ezeket a viselkedéseket kijavítottuk a PowerShell 6-os és újabb verzióiban.

Visszajelzés

Hasznosnak találta ezt az oldalt?

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

Get-Date

Syntax

net (Alapértelmezett)

UFormat

Description

Példák

1. példa: Az aktuális dátum és idő lekérése

2. példa: Az aktuális dátum és idő elemeinek lekérése

3. példa: A dátum és az idő lekérése .NET formátumjelölővel

4. példa: Dátum és idő lekérése egy UFormat-meghatározóval

5. példa: Az év dátumának lekérése

6. példa: Ellenőrizze, hogy a nyári időszámításhoz igazított-e dátumot

7. példa: Az aktuális idő konvertálása UTC-időpontra

8. példa: Időbélyeg létrehozása

9. példa: Invariáns kultúra megjelenítése

Paraméterek

-Date

Paramétertulajdonságok

Paraméterkészletek

-Day

Paramétertulajdonságok

Paraméterkészletek

-DisplayHint

Paramétertulajdonságok

Paraméterkészletek

-Format

Paramétertulajdonságok

Paraméterkészletek

-Hour

Paramétertulajdonságok

Paraméterkészletek

-Millisecond

Paramétertulajdonságok

Paraméterkészletek

-Minute

Paramétertulajdonságok

Paraméterkészletek

-Month

Paramétertulajdonságok

Paraméterkészletek

-Second

Paramétertulajdonságok

Paraméterkészletek

-UFormat

Paramétertulajdonságok

Paraméterkészletek

-Year

Paramétertulajdonságok

Paraméterkészletek

CommonParameters

Bevitelek

DateTime

Kimenetek

DateTime

String

Jegyzetek

Kapcsolódó hivatkozások

Visszajelzés