Get-Date

Sözdizimi

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 işletim sisteminin geçerli 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 süreli biçimlerdedir.

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 DisplayHint parametresini Date bağımsız değişkeniyle birlikte 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 saatlik biçimdeki 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 tanımlayıcısı 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 saatlik biçimdeki 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ündü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ı denetleme

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. $DST tarihin yaz saati için ayarlı olup olmadığını test etmek için IsDaylightSavingTime yöntemini kullanır.

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

Bu örnekte geçerli saat UTC saatine dönüştürülür. Sistemin yerel ayarı için UTC uzaklığı, saati dönüştürmek için 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-Dategeç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.

değişkeni geçerli $Time sistem tarih ve saatini depolar. $TimeToUniversalTime(), saati bilgisayarın UTC uzaklığını temel alarak dönüştürmek için 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 üstelerle sınırlandırılır.

New-Itemyeni 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 bir 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 gösterilmektedir. Örneğin, bu makine Pasifik Standart Saati olarak ayarlanmıştır. Varsayılan olarak, Get-Date o 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

Örnek 11: Sabit kültürü gösterme

geçerli ToString() kültür ayarını kullanarak bir DateTime nesnesini Bir Dizeye dönüştürür. Ancak PowerShell ifade yorumlaması her zaman sabit kültür ayarını kullanır.

Örneğin, kültürün etkin olduğu en-US bir sistemde yöntemi, ToString() kültür ayarlarını kullanarak en-US tarihi biçimlendirebilir.

# 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

Parametreler

-AsUTC

-Date

-Day

-DisplayHint

-Format

-Hour

-Millisecond

-Minute

-Month

-Second

-UFormat

-UnixTimeSeconds

-Year

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 bir cmdlet'e Add-Content gönderildiğinde, PowerShell nesneyi bir String nesnesine dönüştürür.

geçerli ToString() kültür ayarını kullanarak bir DateTime nesnesini Dizeye dönüştürür. Ancak PowerShell ifade yorumlaması her zaman sabit kültür ayarını kullanır. Sabit kültürün ne kadar farklı olduğunu görmek için bkz . Örnek 11.

Bir nesnenin özelliklerini ve yöntemlerini görüntülemek için, nesnesini işlem hattına Get-Membergö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 nesnelerinin çıkışı için varsayılan biçimler, seçili durumdaki yerel ayar için uzun tarih ve uzun saat biçimleridir.

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

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	Asır	2019 için 20
%c	Tarih ve saat - kısaltılmış	27 Haziran 08:44:18 2019
%D	Aa/gg/yyy 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 var	<boşluk>5
%F	YYYY-aa-gg biçiminde, %Y-%m-%d değerine eşit tarih (ISO 8601 tarih biçimi)	2019-06-27
%G	ISO haftası tarih yılı (haftanın Perşembesini içeren yıl)
%g	'G' ile aynı - 2 basamak
%H	24 saatlik biçimde 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	veya PM
%R	24 saatlik biçimdeki süre -saniye yok	17:45
%r	12 saatlik biçimdeki zaman	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	24 saatlik biçimdeki süre	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

İlişkili Bağlantılar

• ForEach-Object
• Get-Culture
• Get-Member
• New-Item
• New-TimeSpan
• Set-Date
• Kültür Ayarla