Get-Date

Referencia

Modul:: Microsoft.PowerShell.Utility

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

Syntax

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

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

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

Get-Date
   -UnixTimeSeconds <Int64>
   [-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. Dátum- vagy idő karaktersorozat létrehozásához, majd a sztring más parancsmagoknak vagy programoknak való elküldéséhez használható Get-Date .

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 következőt (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, Time vagy DateTime argumentumokat használja.

Get-Date -DisplayHint Date

Tuesday, June 25, 2019

Get-Date A DisplayHint paramétert használja a Date argumentummal, hogy csak a dátumot kérje le.

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

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

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

Get-DateA Formátum paraméterrel több formátumkijelö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 az Egyéni dátum- és időformátum sztringjei cí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 sztringobjektum.

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

366

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 kiértékelje.

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ó tárolja $DST a függvény eredményét Get-Date. $DST Az IsDaylightSavingTime metódussal teszteli, 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 egy tábla felsorolja az érvényes UFormat formátumot.

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 Az UFormat paraméter formátumjelölőkkel való használatával jeleníti meg az aktuális rendszerdátumot és időpontot. A(z) %Z formátumjelölő a -07 UTC eltolását jelöli.

A $Time változó az aktuális rendszerdátumot és időpontot tárolja. $Time A metódussal ToUniversalTime() 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élyeg sztringobjektumot 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-DateA Formátum paramétert használja a kisbetűk o formátumjelölőjével egy időbélyeg-sztringobjektum létrehozásához. A rendszer elküldi az objektumot a folyamatnak ForEach-Object. A ScriptBlock az $_ aktuális folyamatobjektumot képviselő változót tartalmazza. Az időbélyeg-sztringet pontokkal helyettesített kettőspontokkal tagolja.

New-ItemAz Elérési út 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: Unix-időbélyeg konvertálása

Ez a példa egy Unix-időt (az 1970-01-01 0:00:00 óta eltelt másodpercek száma) Konvertálja DateTime-ra.

Get-Date -UnixTimeSeconds 1577836800

Wednesday, January 01, 2020 12:00:00 AM

10. példa: UTC-ként értelmezett dátumérték visszaadása

Ez a példa bemutatja, hogyan értelmezhet dátumértéket UTC-ekvivalensként. Ez a gép például csendes-óceáni téli időre van beállítva. Alapértelmezés szerint Get-Date az adott időzónához tartozó értékeket adja vissza. Az AsUTC paraméter használatával konvertálja az értéket utc-ekvivalens időpontra.

PS> Get-TimeZone

Id                         : Pacific Standard Time
DisplayName                : (UTC-08:00) Pacific Time (US & Canada)
StandardName               : Pacific Standard Time
DaylightName               : Pacific Daylight Time
BaseUtcOffset              : -08:00:00
SupportsDaylightSavingTime : True

PS> (Get-Date -Date "2020-01-01T00:00:00").Kind
Unspecified

PS> Get-Date -Date "2020-01-01T00:00:00"

Wednesday, January 1, 2020 12:00:00 AM

PS> (Get-Date -Date "2020-01-01T00:00:00" -AsUTC).Kind
Utc

PS> Get-Date -Date "2020-01-01T00:00:00" -AsUTC

Wednesday, January 1, 2020 8:00:00 AM

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

A ToString() DateTime objektumot sztringgé alakítja 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.

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

# 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

-AsUTC

A dátumértéket az UTC-nek megfelelő időpontra alakítja át.

Ez a paraméter a PowerShell 7.1-ben lett bevezetve.

Típus:	SwitchParameter
Position:	Named
Alapértelmezett érték:	None
Kötelező:	False
Folyamatbemenet elfogadása:	False
Helyettesítő karakterek elfogadása:	False

-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" visszatérés: 2019. június 25. kedd, 12:30:22

Típus:	DateTime
Aliasok:	LastWriteTime
Position:	0
Alapértelmezett érték:	None
Kötelező:	False
Folyamatbemenet elfogadása:	True
Helyettesítő karakterek elfogadása:	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. Például Get-Date -Month 4 -Day 31 a május 1-et jeleníti meg, nem április 31-ét.

Típus:	Int32
Position:	Named
Alapértelmezett érték:	None
Kötelező:	False
Folyamatbemenet elfogadása:	False
Helyettesítő karakterek elfogadása:	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: a dátum és az idő megjelenítése

Típus:	DisplayHintType
Elfogadott értékek:	Date, Time, DateTime
Position:	Named
Alapértelmezett érték:	None
Kötelező:	False
Folyamatbemenet elfogadása:	False
Helyettesítő karakterek elfogadása:	False

-Format

A microsoftos .NET-keretrendszer formátum által megadott dátumot és időt jeleníti meg. A Formátum paraméter egy sztringobjektumot ad ki.

Az elérhető .NET formátumkijelölők listáját az egyéni dátum- és időformátum-sztringekben találja.

A Formátum paraméter használata Get-Date esetén csak a Dátum/idő objektum tulajdonságai jelennek meg a dátum megjelenítéséhez. Emiatt előfordulhat, hogy a DateTime-objektumok néhány tulajdonsága és metódusa nem érhető el.

A PowerShell 5.0-tól kezdve a következő további formátumokat használhatja értékként a Formátum paraméterhez.

FileDate. Az aktuális dátum fájl- vagy útvonalbarát ábrázolása helyi idő szerint. A formátum yyyyMMdd (kis- és nagybetűk megkülönböztetése, 4 jegyű év, 2 jegyű hónap és kétjegyű nap). Például: 20190627.
FileDateUniversal. 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, 2 jegyű perc, 2 jegyű másodperc és 4 számjegyű ezredmásodperc). Például: 20190627T0840107271.
FileDateTimeUniversal. 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, 2 jegyű perc, kétjegyű másodperc, 4 számjegyű ezredmásodperc, a betű Z pedig UTC-jelző). Például: 20190627T1540500718Z.

Típus:	String
Position:	Named
Alapértelmezett érték:	None
Kötelező:	False
Folyamatbemenet elfogadása:	False
Helyettesítő karakterek elfogadása:	False

-Hour

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

Típus:	Int32
Position:	Named
Alapértelmezett érték:	None
Kötelező:	False
Folyamatbemenet elfogadása:	False
Helyettesítő karakterek elfogadása:	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.

Típus:	Int32
Position:	Named
Alapértelmezett érték:	None
Kötelező:	False
Folyamatbemenet elfogadása:	False
Helyettesítő karakterek elfogadása:	False

-Minute

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

Típus:	Int32
Position:	Named
Alapértelmezett érték:	None
Kötelező:	False
Folyamatbemenet elfogadása:	False
Helyettesítő karakterek elfogadása:	False

-Month

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

Típus:	Int32
Position:	Named
Alapértelmezett érték:	None
Kötelező:	False
Folyamatbemenet elfogadása:	False
Helyettesítő karakterek elfogadása:	False

-Second

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

Típus:	Int32
Position:	Named
Alapértelmezett érték:	None
Kötelező:	False
Folyamatbemenet elfogadása:	False
Helyettesítő karakterek elfogadása:	False

-UFormat

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

Az UFormat-jelölőket százalékjel (%például %m, és %d%Y. A Megjegyzések szakasz egy érvényes UFormat-azonosítókat tartalmazó táblát tartalmaz.

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

Típus:	String
Position:	Named
Alapértelmezett érték:	None
Kötelező:	False
Folyamatbemenet elfogadása:	False
Helyettesítő karakterek elfogadása:	False

-UnixTimeSeconds

1970. január 1. óta másodpercben megadott dátum és idő, 0:00:00.

Ez a paraméter a PowerShell 7.1-ben lett bevezetve.

Típus:	Int64
Aliasok:	UnixTime
Position:	Named
Alapértelmezett érték:	None
Kötelező:	True
Folyamatbemenet elfogadása:	False
Helyettesítő karakterek elfogadása:	False

-Year

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

Típus:	Int32
Position:	Named
Alapértelmezett érték:	None
Kötelező:	False
Folyamatbemenet elfogadása:	False
Helyettesítő karakterek elfogadása:	False

Bevitelek

DateTime

Ehhez a parancsmaghoz DateTime-objektumot is csövezhet.

Kimenetek

DateTime

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

Ha egy DateTime-objektumot küld le a folyamatról egy parancsmagra, amely Add-Content sztringbemenetet vár, a PowerShell sztringobjektummá alakítja az objektumot.

A ToString() DateTime objektumot sztringgé alakítja az aktuális kulturális beállítás használatával. 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 a 11. példában olvashat.

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

String

A Formátum vagy az UFormat paraméter használatakor ez a parancsmag sztringobjektumokat ad vissza.

Jegyzetek

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

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

Fontos

Az UFormat-azonosító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-jelölőket 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	Hétfő
`%a`	A hét napja – rövidített név	H
`%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
`%F`	Dátum YYYY-mm-dd formátumban, egyenlő : %Y-%m-%d (AZ ISO 8601 dátumformátum)	2019-06-27
`%G`	ISO-hét dátum éve (a hét csütörtökét tartalmazó év)
`%g`	Ugyanaz, mint a "G" – 2 számjegy
`%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	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 – másodperc nélkül	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 (UTC)	1150451174
`%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 numerikus napja (1–7) (a PowerShell 7.2-ben módosult)	Hétfő = 1, Vasárnap = 7
`%V`	Az év hete	01-53
`%w`	A hét numerikus napja (0-6)	Vasárnap = 0, Szombat = 6
`%W`	Az év hete	00-52
`%X`	Ugyanaz, mint a "T"
`%x`	Dátum szabványos formátumban a területi beállításhoz	06/27/19 for 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

Feljegyzés

A viselkedés módosult -UFormat %s a Windows PowerShell viselkedésével kapcsolatos problémák megoldásához.

A visszatérési érték az UTC-idő alapján történik.
Az érték másodpercek egész száma (törtrész nélkül).

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

Get-Date

Syntax

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: Unix-időbélyeg konvertálása

10. példa: UTC-ként értelmezett dátumérték visszaadása

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

Paraméterek

-AsUTC

-Date

-Day

-DisplayHint

-Format

-Hour

-Millisecond

-Minute

-Month

-Second

-UFormat

-UnixTimeSeconds

-Year

Bevitelek

Kimenetek

Jegyzetek

További források

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

Get-Date

Syntax

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: Unix-időbélyeg konvertálása

10. példa: UTC-ként értelmezett dátumérték visszaadása

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

Paraméterek

-AsUTC

-Date

-Day

-DisplayHint

-Format

-Hour

-Millisecond

-Minute

-Month

-Second

-UFormat

-UnixTimeSeconds

-Year

Bevitelek

Kimenetek

Jegyzetek

Kapcsolódó hivatkozások

További források