Get-Date

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>]
    -UFormat <String>
    [-Year <Int32>]
    [-Month <Int32>]
    [-Day <Int32>]
    [-Hour <Int32>]
    [-Minute <Int32>]
    [-Second <Int32>]
    [-Millisecond <Int32>]
    [-DisplayHint <DisplayHintType>]
    [<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>
    -UFormat <String>
    [-Year <Int32>]
    [-Month <Int32>]
    [-Day <Int32>]
    [-Hour <Int32>]
    [-Minute <Int32>]
    [-Second <Int32>]
    [-Millisecond <Int32>]
    [-DisplayHint <DisplayHintType>]
    [<CommonParameters>]

Cmdleten Get-Date hämtar ett DateTime- objekt som representerar det aktuella datumet eller ett datum som du anger. Get-Date kan formatera datum och tid i flera .NET- och Unix-format. Du kan använda Get-Date för att generera en datum- eller tidsteckensträng och sedan skicka strängen till andra cmdletar eller program.

Get-Date använder de aktuella kulturinställningarna i operativsystemet för att avgöra hur utdata formateras. Om du vill visa datorns inställningar använder du (Get-Culture).DateTimeFormat.

I det här exemplet visar Get-Date det aktuella systemets datum och tid. Utdata är i formaten long-date och long-time.

Get-Date

Tuesday, June 25, 2019 14:53:32

Det här exemplet visar hur du använder Get-Date för att hämta antingen datum- eller tidselementet. Parametern använder argumenten Date, Timeeller DateTime.

Get-Date -DisplayHint Date

Tuesday, June 25, 2019

Get-Date använder parametern DisplayHint med argumentet Date för att endast hämta datumet.

I det här exemplet används en .NET-formatspecificerare för att anpassa utdataformatet. Utdata är ett String-objekt.

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

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

Get-Date använder parametern Format för att ange flera formatspecificerare.

De .NET-formatspecificerare som används i det här exemplet definieras på följande sätt:

Mer information om .NET-formatsspecificerare finns i Anpassade datum- och tidsformatsträngar.

I det här exemplet används flera UFormat formatspecificerare för att anpassa utdataformatet. Utdata är ett String-objekt.

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

Tuesday 06/25/2019 16:19 -07

Get-Date använder parametern UFormat för att ange flera formatspecificerare.

De UFormat formatspecificerare som används i det här exemplet definieras på följande sätt:

En lista över giltiga UFormat formatspecificerare finns i avsnittet Anteckningar.

I det här exemplet används en egenskap för att hämta den numeriska dagen på året.

Den gregorianska kalendern har 365 dagar, förutom skottår som har 366 dagar. Till exempel är 31 december 2020 dag 366.

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

366

Get-Date använder tre parametrar för att ange datumet: Year, Monthoch Day. Kommandot omsluts med parenteser så att resultatet utvärderas av egenskapen DayOfYear.

I det här exemplet används en boolesk metod för att kontrollera om ett datum justeras efter sommartid.

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

True

En variabel som $DST lagrar resultatet av Get-Date. $DST använder metoden IsDaylightSavingTime för att testa om datumet justeras för sommartid.

I det här exemplet konverteras den aktuella tiden till UTC-tid. UTC-förskjutningen för systemets nationella inställningar används för att konvertera tiden. En tabell i avsnittet Anteckningar visar en lista över giltiga UFormat formatspecificerare.

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 använder parametern UFormat med formatspecificerare för att visa det aktuella systemets datum och tid. Formatspecificeraren %Z representerar UTC-förskjutningen för -07.

Variabeln $Time lagrar det aktuella systemets datum och tid. $Time använder metoden ToUniversalTime() för att konvertera tiden baserat på datorns UTC-förskjutning.

I det här exemplet skapar en formatspecificerare en tidsstämpel String-objekt för ett katalognamn. Tidsstämpeln innehåller förskjutningen datum, tid och UTC.

$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

Variabeln $timestamp lagrar resultatet av ett Get-Date kommando. Get-Date använder parametern Format med formatspecificeraren för gemener o för att skapa ett tidsstämpelobjekt String. Objektet skickas ned i pipelinen till ForEach-Object. En ScriptBlock- innehåller variabeln $_ som representerar det aktuella pipelineobjektet. Tidsstämpelsträngen avgränsas av kolon som ersätts av punkter.

New-Item använder parametern Path för att ange platsen för en ny katalog. Sökvägen innehåller variabeln $timestamp som katalognamn. Parametern Type anger att en katalog skapas.

Det här exemplet konverterar en Unix-tid (representeras av antalet sekunder sedan 1970-01-01 0:00:00) till DateTime.

Get-Date -UnixTimeSeconds 1577836800

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

Det här exemplet visar hur du tolkar ett datumvärde som dess UTC-motsvarighet. Till exempel är den här datorn inställd på Pacific Standard Time. Som standard returnerar Get-Date värden för tidszonen. Använd parametern AsUTC för att konvertera värdet till UTC-motsvarande tid.

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

ToString() konverterar ett DateTime--objekt till ett String- med den aktuella kulturinställningen. PowerShell-uttryckstolkning använder dock alltid den invarianta kulturinställningen.

I ett system med en-US kultur i praktiken formaterar metoden ToString() till exempel datumet med hjälp av en-US kulturinställningar.

# 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

Den här cmdleten stöder vanliga parametrar: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction och -WarningVariable. Mer information finns i about_CommonParameters.

Du kan skicka ett DateTime- objekt till den här cmdleten.

Som standard returnerar den här cmdleten ett DateTime- objekt.

När ett DateTime--objekt skickas ned pipelinen till en cmdlet, till exempel Add-Content som förväntar sig strängindata, konverterar PowerShell objektet till ett String-objekt.

ToString() konverterar ett DateTime--objekt till en String- med den aktuella kulturinställningen. PowerShell-uttryckstolkning använder dock alltid den invarianta kulturinställningen. Information om hur invariant kultur skiljer sig åt finns i Exempel 11.

Om du vill visa ett objekts egenskaper och metoder skickar du objektet nedåt i pipelinen för att Get-Member. Till exempel Get-Date | Get-Member.

När du använder parametrarna Format eller UFormat returnerar den här cmdleten String-objekt.

Standardformaten för utdata från DateTime- objekt är långa datum- och långtidsformat för det valda språket.

Giltiga UFormat-specificerare visas i följande tabell: