Get-Date
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, 2019Get-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:00Get-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 -07Get-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
366Get-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()
Truedeğ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:26Get-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 AMParametreler
-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 |
| Required: | False |
| 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 |
| Required: | False |
| 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 |
| Required: | False |
| 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 |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Format
Tarih ve saati Microsoft .NET Framework biçiminde, biçim belirtici tarafından belirtilen biçimde 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 harfZkullanı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 harfT, 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 (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 harfT, 2 basamaklı saat, 2 basamaklı dakika, 2 basamaklı saniye, 4 basamaklı milisaniye ve UTC göstergesi olarak harfZ). Örneğin: 20190627T1540500718Z.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Hour
Görüntülenen saati belirtir. 0 ile 23 bir değer girin.
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Millisecond
Tarihteki milisaniyeleri belirtir. 0 ile 999 için bir değer girin.
Bu parametre PowerShell 3.0'da kullanıma sunulmuştur.
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Minute
Görüntülenen dakikayı belirtir. 0 ile 59 bir değer girin.
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Month
Görüntülenen ayı belirtir. 1 ile 12 bir değer girin.
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Second
Görüntülenen saniyeyi belirtir. 0 ile 59 bir değer girin.
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| 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 |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-UnixTimeSeconds
1 Ocak 1970, 0:00:00 tarihinden itibaren saniye cinsinden gösterilen tarih ve saat.
Bu parametre PowerShell 7.1'de tanıtıldı.
| Type: | Int64 |
| Aliases: | UnixTime |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Year
Görüntülenen yılı belirtir. 1 ile 9999 için bir değer girin.
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Girişler
Pipeline input
Get-Date işlem hattı girişini kabul eder. Örneğin, Get-ChildItem | Get-Date.
Çıkışlar
System.DateTime or System.String
Get-DateFormat ve UFormat parametrelerinin kullanılması dışında bir DateTime nesnesi döndürür. Format veya UFormat parametreleri String nesneleri 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.
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:
| 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 |
'Y' ile aynı | |
%g |
'y' ile aynı | |
%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'dan 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 günü - sayı | Pazar = 0 |
%V |
Yılın haftası | 01-53 |
%w |
'u' ile aynı | |
%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 |