Get-Date

Başvuru

Modül:: Microsoft.PowerShell.Utility

Geçerli tarih ve saati alır.

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

Cmdlet, Get-Date geçerli tarihi veya belirttiğiniz tarihi temsil eden bir DateTime nesnesi alır. Get-Date tarih ve saati çeşitli .NET ve UNIX biçimlerinde biçimlendirebilir. Bir tarih veya saat karakter dizesi oluşturmak ve ardından dizeyi diğer cmdlet'lere veya programlara göndermek için kullanabilirsiniz Get-Date .

Get-Date çıkışın nasıl biçimlendirildiğini belirlemek için bilgisayarın kültür ayarlarını kullanır. Bilgisayarınızın ayarlarını görüntülemek için kullanın (Get-Culture).DateTimeFormat.

Örnekler

Örnek 1: Geçerli tarih ve saati alma

Bu örnekte, Get-Date geçerli sistem tarih ve saatini görüntüler. Çıkış, uzun tarih ve uzun saat biçimlerindedir.

Get-Date

Tuesday, June 25, 2019 14:53:32

Örnek 2: Geçerli tarih ve saatin öğelerini alma

Bu örnekte, tarih veya saat öğesini almak için nasıl kullanılacağı Get-Date gösterilmektedir. parametresi Date, Time veya DateTime bağımsız değişkenlerini kullanır.

Get-Date -DisplayHint Date

Tuesday, June 25, 2019

Get-Dateyalnızca tarihi almak için Date bağımsız değişkeniyle DisplayHint parametresini kullanır.

Örnek 3: .NET biçim tanımlayıcısı ile tarih ve saati alma

Bu örnekte, çıkışın biçimini özelleştirmek için bir .NET biçim tanımlayıcısı kullanılır. Çıkış bir String nesnesidir.

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

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

Get-Date çeşitli biçim tanımlayıcıları belirtmek için Format parametresini kullanır.

Bu örnekte kullanılan .NET biçim tanımlayıcıları aşağıdaki gibi tanımlanır:

Belirleyici	Tanım
`dddd`	Haftanın günü - tam ad
`MM`	Ay numarası
`dd`	Ayın günü - 2 basamak
`yyyy`	4 basamaklı biçimde yıl
`HH:mm`	24 saat biçimindeki süre - saniye yok
`K`	Evrensel Saat Koordinatı'ndan saat dilimi uzaklığı (UTC)

.NET biçim tanımlayıcıları hakkında daha fazla bilgi için bkz . Özel tarih ve saat biçimi dizeleri.

Örnek 4: UFormat tanımlayıcısı ile tarih ve saati alma

Bu örnekte, çıkışın biçimini özelleştirmek için birkaç UFormat biçim belirticisi kullanılır. Çıkış bir String nesnesidir.

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

Tuesday 06/25/2019 16:19 -07

Get-Date çeşitli biçim tanımlayıcıları belirtmek için UFormat parametresini kullanır.

Bu örnekte kullanılan UFormat biçim tanımlayıcıları aşağıdaki gibi tanımlanır:

Belirleyici	Tanım
`%A`	Haftanın günü - tam ad
`%m`	Ay numarası
`%d`	Ayın günü - 2 basamak
`%Y`	4 basamaklı biçimde yıl
`%R`	24 saat biçimindeki süre - saniye yok
`%Z`	Evrensel Saat Koordinatı'ndan saat dilimi uzaklığı (UTC)

Geçerli UFormat biçim tanımlayıcılarının listesi için Notlar bölümüne bakın.

Örnek 5: Yılın tarihini alma

Bu örnekte, yılın sayısal gününü almak için bir özellik kullanılır.

Gregoryen takvimin 366 günü olan artık yıllar dışında 365 günü vardır. Örneğin, 31 Aralık 2020 366 günüdür.

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

366

Get-Date tarihi belirtmek için üç parametre kullanır: Year, Month ve Day. Komut parantezlerle sarmalanır, böylece sonuç DayofYear özelliği tarafından değerlendirilir.

Örnek 6: Bir tarihin gün ışığından yararlanma saati için ayarlı olup olmadığını denetleyin

Bu örnekte, bir tarihin yaz saatiyle ayarlı olup olmadığını doğrulamak için boole yöntemi kullanılır.

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

True

değişkeni, $DST sonucunu Get-Datedepolar. $DSTIsDaylightSavingTime yöntemini kullanarak tarihin yaz saati için ayarlı olup olmadığını test eder.

Örnek 7: Geçerli saati UTC saatine dönüştürme

Bu örnekte geçerli saat UTC saatine dönüştürülür. Saati dönüştürmek için sistemin yerel ayarı için UTC uzaklığı kullanılır. Notlar bölümündeki bir tabloda geçerli UFormat biçim tanımlayıcıları listelenir.

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 geçerli sistem tarih ve saatini görüntülemek için biçim tanımlayıcılarıyla UFormat parametresini kullanır. %Z biçim belirticisi -07 UTC uzaklığını temsil eder.

$Time değişkeni geçerli sistem tarih ve saatini depolar. $Time , saati bilgisayarın UTC uzaklığını temel alarak dönüştürmek için ToUniversalTime() yöntemini kullanır.

Örnek 8: Zaman damgası oluşturma

Bu örnekte, biçim belirtici bir dizin adı için bir zaman damgası String nesnesi oluşturur. Zaman damgası tarih, saat ve UTC uzaklığını içerir.

$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

$timestamp değişkeni bir Get-Date komutun sonuçlarını depolar. Get-Datebir zaman damgası String nesnesi oluşturmak için Küçük harf o biçim belirticisiyle Format parametresini kullanır. nesnesi işlem hattına ForEach-Objectgönderilir. ScriptBlock, geçerli işlem hattı nesnesini temsil eden değişkeni içerir$_. Zaman damgası dizesi, noktalarla değiştirilen iki nokta üst üste ile sınırlandırılır.

New-Item yeni bir dizinin konumunu belirtmek için Path parametresini kullanır. Yol, dizin adı olarak değişkenini içerir $timestamp . Type parametresi bir dizinin oluşturulduğunu belirtir.

Örnek 9: Unix zaman damgasını dönüştürme

Bu örnek, Unix saatini (1970-01-01 0:00:00'dan bu yana saniye sayısıyla gösterilir) DateTime'a dönüştürür.

Get-Date -UnixTimeSeconds 1577836800

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

Örnek 10: UTC olarak yorumlanan bir tarih değeri döndürme

Bu örnekte, bir tarih değerini UTC eşdeğeri olarak yorumlama işlemi gösterilmektedir. Örneğin, bu makine Pasifik Standart Saati olarak ayarlanmıştır. Varsayılan olarak, Get-Date bu saat dilimi için değerleri döndürür. Değeri UTC eşdeğer saatine dönüştürmek için AsUTC parametresini kullanın.

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

Parametreler

-AsUTC

Tarih değerini UTC ile eşdeğer saate dönüştürür.

Bu parametre PowerShell 7.1'de kullanıma sunulmuştur.

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

-Date

Bir tarih ve saat belirtir. Saat isteğe bağlıdır ve belirtilmezse 00:00:00 döndürür.

Tarih ve saati sistem yerel ayarı için standart bir biçimde girin.

Örneğin, ABD İngilizcesi:

Get-Date -Date "6/25/2019 12:30:22" döndürür 25 Haziran 2019 Salı 12:30:22

Type:	DateTime
Aliases:	LastWriteTime
Position:	0
Default value:	None
Accept pipeline input:	True
Accept wildcard characters:	False

-Day

Görüntülenen ayın gününü belirtir. 1 ile 31 arasına bir değer girin.

Belirtilen değer bir aydaki gün sayısından büyükse, PowerShell aya gün sayısını ekler. Örneğin, Get-Date -Month 2 -Day 3131 Şubat'ı değil 3 Mart'ı görüntüler.

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

-DisplayHint

Tarih ve saatin hangi öğelerinin görüntüleneceğini belirler.

Kabul edilen değerler şunlardır:

Tarih: Yalnızca tarihi görüntüler
Saat: Yalnızca saati görüntüler
DateTime: Tarih ve saati görüntüler

Type:	DisplayHintType
Accepted values:	Date, Time, DateTime
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-Format

Tarih ve saati, biçim belirtici tarafından belirtilen Microsoft .NET Framework biçiminde görüntüler. Format parametresi bir String nesnesi verir.

Kullanılabilir .NET biçim tanımlayıcılarının listesi için bkz . Özel tarih ve saat biçimi dizeleri.

Format parametresi kullanıldığında, Get-Date yalnızca tarihi görüntülemek için gereken DateTime nesnesinin özelliklerini alır. Sonuç olarak, DateTime nesnelerinin bazı özellikleri ve yöntemleri kullanılamayabilir.

PowerShell 5.0'dan başlayarak, Format parametresi için değer olarak aşağıdaki ek biçimleri kullanabilirsiniz.

DosyaTarihi. Geçerli tarihin yerel saatteki dosya veya yol dostu gösterimi. Biçim (büyük/küçük harfe duyarlıdır yyyyMMdd , 4 basamaklı yıl, 2 basamaklı ay ve 2 basamaklı gün kullanılır). Örneğin: 20190627.
FileDateUniversal. Geçerli tarihin evrensel saat (UTC) olarak dosya veya yol dostu gösterimi. Biçim şöyledir (büyük/küçük harfe duyarlıdır yyyyMMddZ , 4 basamaklı yıl, 2 basamaklı ay, 2 basamaklı gün ve UTC göstergesi olarak harf Z kullanılır). Örneğin: 20190627Z.
FileDateTime. Geçerli tarih ve saatin yerel saatle 24 saatlik biçimde dosya veya yol dostu gösterimi. Biçim (büyük/küçük harfe duyarlıdır yyyyMMddTHHmmssffff , 4 basamaklı yıl, 2 basamaklı ay, 2 basamaklı gün, saat ayırıcı olarak harf T , 2 basamaklı saat, 2 basamaklı dakika, 2 basamaklı saniye ve 4 basamaklı milisaniye kullanılır). Örneğin: 20190627T0840107271.
FileDateTimeUniversal. Geçerli tarih ve saatin evrensel saat (UTC) olarak 24 saat biçiminde dosya veya yol dostu gösterimi. Biçim şöyledir (büyük/küçük harfe duyarlıdır yyyyMMddTHHmmssffffZ ; 4 basamaklı yıl, 2 basamaklı ay, 2 basamaklı gün, saat ayırıcı olarak harf T , 2 basamaklı saat, 2 basamaklı dakika, 2 basamaklı saniye, 4 basamaklı milisaniye ve UTC göstergesi olarak harf Z ). Örneğin: 20190627T1540500718Z.

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

-Hour

Görüntülenen saati belirtir. 0 ile 23 arasına bir değer girin.

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

-Millisecond

Tarihteki milisaniyeleri belirtir. 0 ile 999 arasına bir değer girin.

Bu parametre PowerShell 3.0'da kullanıma sunulmuştur.

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

-Minute

Görüntülenen dakikayı belirtir. 0 ile 59 arasına bir değer girin.

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

-Month

Görüntülenen ayı belirtir. 1 ile 12 arasına bir değer girin.

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

-Second

Görüntülenen saniyeyi belirtir. 0 ile 59 arasına bir değer girin.

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

-UFormat

Tarih ve saati UNIX biçiminde görüntüler. UFormat parametresi bir dize nesnesi verir.

UFormat tanımlayıcılarının önünde , ve %Ygibi %m%dbir yüzde işareti ()% bulunur. Notlar bölümü geçerli UFormat tanımlayıcılarından oluşan bir tablo içerir.

UFormat parametresi kullanıldığında, Get-Date yalnızca tarihi görüntülemek için gereken DateTime nesnesinin özelliklerini alır. Sonuç olarak, DateTime nesnelerinin bazı özellikleri ve yöntemleri kullanılamayabilir.

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

-UnixTimeSeconds

1 Ocak 1970, 0:00:00'dan bu yana saniye cinsinden gösterilen tarih ve saat.

Bu parametre PowerShell 7.1'de kullanıma sunulmuştur.

Type:	Int64
Aliases:	UnixTime
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-Year

Görüntülenen yılı belirtir. 1 ile 9999 arasından bir değer girin.

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

Girişler

DateTime

Bir DateTime nesnesini bu cmdlet'e yöneltebilirsiniz.

Çıkışlar

DateTime

Varsayılan olarak, bu cmdlet bir DateTime nesnesi döndürür.

Bir DateTime nesnesi işlem hattını dize girişi bekleyen gibi Add-Content bir cmdlet'e gönderildiğinde, PowerShell nesneyi bir String nesnesine dönüştürür.

yöntemi (Get-Date).ToString() bir DateTime nesnesini String nesnesine dönüştürür.

Bir nesnenin özelliklerini ve yöntemlerini görüntülemek için, nesnesini işlem hattında Get-Memberadresine gönderin. Örneğin, Get-Date | Get-Member.

String

Format veya UFormat parametrelerini kullandığınızda, bu cmdlet String nesnelerini döndürür.

Notlar

DateTime nesneleri, sistem yerel ayarı için uzun tarih ve uzun saat biçimlerindedir.

Geçerli UFormat tanımlayıcıları aşağıdaki tabloda görüntülenir:

Önemli

UFormat tanımlayıcıları, PowerShell'in daha yeni sürümlerinde değiştirilir veya eklenir. Örneğin, %F PowerShell 6.2'ye eklendiğinden, Windows PowerShell 5.1 veya daha eski sürümlerinde kullanılamaz. PowerShell'in birden çok sürümünde çalıştırılacak şekilde tasarlanmış betiklerde UFormat tanımlayıcılarını kullanırken bunu aklınızda bulundurun.

Biçim belirteci	Anlamı	Örnek
`%A`	Haftanın günü - tam ad	Pazartesi
`%a`	Haftanın günü - kısaltılmış ad	Pzt
`%B`	Ay adı - tam	Ocak
`%b`	Ay adı - kısaltılmış	Oca
`%C`	Yüzyıl	2019 için 20
`%c`	Tarih ve saat - kısaltılmış	27 Haziran 08:44:18 2019 Per
`%D`	Aa/gg/yy biçiminde tarih	06/27/19
`%d`	Ayın günü - 2 basamak	05
`%e`	Ayın günü - yalnızca tek bir basamak varsa önünde boşluk vardır	<boşluk>5
`%F`	Tarih YYYY-aa-gg biçiminde, eşittir %Y-%m-%d (ISO 8601 tarih biçimi)	2019-06-27
`%G`	ISO hafta tarihi yıl (haftanın Perşembe günü içeren yıl)
`%g`	'G' ile aynı - 2 basamak
`%H`	24 saat biçiminde saat	17
`%h`	'b' ile aynı
`%I`	12 saatlik biçimde saat	05
`%j`	Yılın günü	1-366
`%k`	'H' ile aynı
`%l`	'I' ile aynı (Büyük harf I)	05
`%M`	Dakika	35
`%m`	Ay numarası	06
`%n`	yeni satır karakteri
`%p`	AM veya PM
`%R`	24 saat biçimindeki süre -saniye yok	17:45
`%r`	Saat 12 saatlik biçimde	09:15:36
`%S`	Saniye	05
`%s`	1 Ocak 1970 00:00:00 (UTC) tarihinden bu yana geçen saniye sayısı	1150451174
`%t`	Yatay sekme karakteri
`%T`	Saat 24 saatlik biçimde	17:45:52
`%U`	'W' ile aynı
`%u`	Haftanın sayısal günü (1-7) (PowerShell 7.2'de değiştirildi)	Pazartesi = 1, Pazar = 7
`%V`	Yılın haftası	01-53
`%w`	Haftanın sayısal günü (0-6)	Pazar = 0, Cumartesi = 6
`%W`	Yılın haftası	00-52
`%X`	'T' ile aynı
`%x`	Yerel ayar için standart biçimde tarih	İngilizce-ABD için 27.06.19
`%Y`	4 basamaklı biçimde yıl	2019
`%y`	2 basamaklı biçimde yıl	19
`%Z`	Evrensel Saat Koordinatı'ndan saat dilimi uzaklığı (UTC)	-07

Not

davranışı-UFormat %s, Windows PowerShell davranışla ilgili sorunları düzeltmek için değiştirildi.

Dönüş değeri UTC saatini temel alır.
Değer, bir tamsayı saniye değeridir (kesirli bölüm yoktur).

Get-Date

Syntax

Description

Örnekler

Örnek 1: Geçerli tarih ve saati alma

Örnek 2: Geçerli tarih ve saatin öğelerini alma

Örnek 3: .NET biçim tanımlayıcısı ile tarih ve saati alma

Örnek 4: UFormat tanımlayıcısı ile tarih ve saati alma

Örnek 5: Yılın tarihini alma

Örnek 6: Bir tarihin gün ışığından yararlanma saati için ayarlı olup olmadığını denetleyin

Örnek 7: Geçerli saati UTC saatine dönüştürme

Örnek 8: Zaman damgası oluşturma

Örnek 9: Unix zaman damgasını dönüştürme

Örnek 10: UTC olarak yorumlanan bir tarih değeri döndürme

Parametreler

-AsUTC

-Date

-Day

-DisplayHint

-Format

-Hour

-Millisecond

-Minute

-Month

-Second

-UFormat

-UnixTimeSeconds

-Year

Girişler

Çıkışlar

Notlar

Geri Bildirim

Ek kaynaklar

Get-Date

Syntax

Description

Örnekler

Örnek 1: Geçerli tarih ve saati alma

Örnek 2: Geçerli tarih ve saatin öğelerini alma

Örnek 3: .NET biçim tanımlayıcısı ile tarih ve saati alma

Örnek 4: UFormat tanımlayıcısı ile tarih ve saati alma

Örnek 5: Yılın tarihini alma

Örnek 6: Bir tarihin gün ışığından yararlanma saati için ayarlı olup olmadığını denetleyin

Örnek 7: Geçerli saati UTC saatine dönüştürme

Örnek 8: Zaman damgası oluşturma

Örnek 9: Unix zaman damgasını dönüştürme

Örnek 10: UTC olarak yorumlanan bir tarih değeri döndürme

Parametreler

-AsUTC

-Date

-Day

-DisplayHint

-Format

-Hour

-Millisecond

-Minute

-Month

-Second

-UFormat

-UnixTimeSeconds

-Year

Girişler

Çıkışlar

Notlar

İlişkili Bağlantılar

Geri Bildirim

Ek kaynaklar