Get-Date

Referentie

Module:: Microsoft.PowerShell.Utility

Hiermee haalt u de huidige datum en tijd op.

Syntaxis

Get-Date
   [[-Date] <datetime>]
   [-Year <int>]
   [-Month <int>]
   [-Day <int>]
   [-Hour <int>]
   [-Minute <int>]
   [-Second <int>]
   [-Millisecond <int>]
   [-DisplayHint <DisplayHintType>]
   [-Format <string>]
   [<CommonParameters>]

Get-Date
   [[-Date] <datetime>]
   [-Year <int>]
   [-Month <int>]
   [-Day <int>]
   [-Hour <int>]
   [-Minute <int>]
   [-Second <int>]
   [-Millisecond <int>]
   [-DisplayHint <DisplayHintType>]
   [-UFormat <string>]
   [<CommonParameters>]

Description

Met de cmdlet Get-Date wordt een DateTime--object opgehaald dat de huidige datum of een datum aangeeft die u opgeeft. Get-Date kunt de datum en tijd in verschillende .NET- en UNIX-indelingen opmaken. U kunt Get-Date gebruiken om een tekenreeks voor datum of tijd te genereren en de tekenreeks vervolgens naar andere cmdlets of programma's te verzenden.

Get-Date de cultuurinstellingen van de computer gebruikt om te bepalen hoe de uitvoer wordt opgemaakt. Gebruik (Get-Culture).DateTimeFormatom de instellingen van uw computer weer te geven.

Voorbeelden

Voorbeeld 1: De huidige datum en tijd ophalen

In dit voorbeeld geeft Get-Date de huidige systeemdatum en -tijd weer. De uitvoer heeft de indelingen lange datum en lange tijd.

Get-Date

Tuesday, June 25, 2019 14:53:32

Voorbeeld 2: Elementen van de huidige datum en tijd ophalen

In dit voorbeeld ziet u hoe u Get-Date gebruikt om het datum- of tijdelement op te halen. De parameter gebruikt de argumenten Date, Timeof DateTime.

Get-Date -DisplayHint Date

Tuesday, June 25, 2019

Get-Date gebruikt de parameter DisplayHint met het argument Date om alleen de datum op te halen.

Voorbeeld 3: De datum en tijd ophalen met een .NET-indelingsaanduiding

In dit voorbeeld wordt een .NET-indelingsaanduiding gebruikt om de indeling van de uitvoer aan te passen. De uitvoer is een Tekenreeks-object.

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

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

Get-Date gebruikt de parameter Format om verschillende opmaakaanduidingen op te geven.

De .NET-indelingsaanduidingen die in dit voorbeeld worden gebruikt, worden als volgt gedefinieerd:

Aanduiding	Definitie
`dddd`	Dag van de week - volledige naam
`MM`	Maandnummer
`dd`	Dag van de maand - 2 cijfers
`yyyy`	Jaar in 4-cijferige notatie
`HH:mm`	Tijd in 24-uursnotatie -no seconden
`K`	Tijdzone-verschuiving van Universal Time Coördinaat (UTC)

Zie Aangepaste datum- en tijdnotatietekenreeksenvoor meer informatie over .NET-indelingsaanduidingen.

Voorbeeld 4: De datum en tijd ophalen met een UFormat-aanduiding

In dit voorbeeld worden verschillende UFormat opmaakaanduidingen gebruikt om de indeling van de uitvoer aan te passen. De uitvoer is een Tekenreeks-object.

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

Tuesday 06/25/2019 16:19 -07

Get-Date gebruikt de parameter UFormat om verschillende opmaakaanduidingen op te geven.

De UFormat indelingsaanduidingen die in dit voorbeeld worden gebruikt, worden als volgt gedefinieerd:

Aanduiding	Definitie
`%A`	Dag van de week - volledige naam
`%m`	Maandnummer
`%d`	Dag van de maand - 2 cijfers
`%Y`	Jaar in 4-cijferige notatie
`%R`	Tijd in 24-uursnotatie -no seconden
`%Z`	Tijdzone-verschuiving van Universal Time Coördinaat (UTC)

Zie de sectie Notities voor een lijst met geldige UFormat opmaakaanduidingen.

Voorbeeld 5: Een datumdag van het jaar ophalen

In dit voorbeeld wordt een eigenschap gebruikt om de numerieke dag van het jaar op te halen.

De Gregoriaanse kalender heeft 365 dagen, met uitzondering van schrikkeljaren die 366 dagen hebben. Bijvoorbeeld: 31 december 2020 is dag 366.

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

366

Get-Date gebruikt drie parameters om de datum op te geven: Year, Monthen Day. De opdracht wordt verpakt met haakjes, zodat het resultaat wordt geëvalueerd door de eigenschap DayofYear.

Voorbeeld 6: Controleren of een datum is aangepast voor zomertijd

In dit voorbeeld wordt een Booleaanse methode gebruikt om te controleren of een datum wordt aangepast door zomertijd.

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

True

Een variabele, $DST slaat het resultaat van Get-Dateop. $DST de methode IsDaylightSavingTime gebruikt om te testen of de datum is aangepast voor zomertijd.

Voorbeeld 7: De huidige tijd converteren naar UTC-tijd

In dit voorbeeld wordt de huidige tijd geconverteerd naar UTC-tijd. De UTC-offset voor de landinstelling van het systeem wordt gebruikt om de tijd te converteren. Een tabel in de sectie Notities bevat de geldige UFormat opmaakaanduidingen.

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 gebruikt de parameter UFormat met notatieaanduidingen om de huidige systeemdatum en -tijd weer te geven. De notatieaanduiding %Z vertegenwoordigt de UTC-offset van -07.

De $Time-variabele slaat de huidige systeemdatum en -tijd op. $Time gebruikt de methode ToUniversalTime() om de tijd te converteren op basis van de UTC-offset van de computer.

Voorbeeld 8: Een tijdstempel maken

In dit voorbeeld maakt een notatieaanduiding een tijdstempel Tekenreeks-object voor een mapnaam. De tijdstempel bevat de offset datum, tijd en 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

De $timestamp-variabele slaat de resultaten van een Get-Date-opdracht op. Get-Date gebruikt de parameter Format met de notatieaanduiding van kleine letters o om een tijdstempel te maken tekenreeks-object. Het object wordt naar ForEach-Objectverzonden. Een ScriptBlock- bevat de $_ variabele die het huidige pijplijnobject vertegenwoordigt. De tijdstempeltekenreeks wordt gescheiden door dubbele punten die worden vervangen door punten.

New-Item gebruikt de parameter Path om de locatie voor een nieuwe map op te geven. Het pad bevat de variabele $timestamp als mapnaam. De parameter Type geeft aan dat er een map wordt gemaakt.

Parameters

-Date

Hiermee geeft u een datum en tijd. De tijd is optioneel en indien niet opgegeven, wordt 00:00:00 geretourneerd.

Voer de datum en tijd in een indeling in die standaard is voor de landinstelling van het systeem.

Bijvoorbeeld in het Engels in de VS:

Get-Date -Date "6/25/2019 12:30:22" retourneert dinsdag 25 juni 2019 12:30:22

Type:	DateTime
Aliassen:	LastWriteTime
Position:	0
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	True
Jokertekens accepteren:	False

-Day

Hiermee geeft u de dag van de maand die wordt weergegeven. Voer een waarde in tussen 1 en 31.

Als de opgegeven waarde groter is dan het aantal dagen in een maand, voegt PowerShell het aantal dagen toe aan de maand. Get-Date -Month 2 -Day 31 geeft bijvoorbeeld 3 maartweer, niet 31 februari.

Type:	Int
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-DisplayHint

Bepaalt welke elementen van de datum en tijd worden weergegeven.

De geaccepteerde waarden zijn als volgt:

Datum: alleen de datum weergeven
tijd: alleen de tijd weergeven
Datum/tijd-: geeft de datum en tijd weer

Type:	DisplayHintType
Geaccepteerde waarden:	Date, Time, DateTime
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-Format

Geeft de datum en tijd weer in de Microsoft .NET Framework-indeling die wordt aangegeven door de notatieaanduiding. De parameter Format voert een string-object uit.

Zie Tekenreeksen voor aangepaste datum- en tijdnotatiesvoor een lijst met beschikbare .NET-indelingsaanduidingen.

Wanneer de parameter Format wordt gebruikt, haalt Get-Date alleen de eigenschappen van het DateTime object op die nodig zijn om de datum weer te geven. Als gevolg hiervan zijn sommige eigenschappen en methoden van DateTime--objecten mogelijk niet beschikbaar.

Vanaf PowerShell 5.0 kunt u de volgende extra indelingen gebruiken als waarden voor de parameter Format.

FileDate-. Een bestand of padvriendelijke weergave van de huidige datum in de lokale tijd. De notatie is yyyyMMdd (hoofdlettergevoelig, met behulp van een jaar van 4 cijfers, maand met 2 cijfers en dag van 2 cijfers). Bijvoorbeeld: 20190627.
FileDateUniversal-. Een bestand of padvriendelijke weergave van de huidige datum in universele tijd (UTC). De notatie is yyyyMMddZ (hoofdlettergevoelig, met behulp van een jaar van 4 cijfers, maand met 2 cijfers, dag van 2 cijfers en de letter Z als de UTC-indicator). Bijvoorbeeld: 20190627Z.
FileDateTime-. Een bestand of padvriendelijke weergave van de huidige datum en tijd in lokale tijd, in 24-uursnotatie. De notatie is yyyyMMddTHHmmssffff (hoofdlettergevoelig, met behulp van een jaar van 4 cijfers, maand van 2 cijfers, dag van 2 cijfers, de letter T als tijdscheidingsteken, 2-cijferig uur, minuut van 2 cijfers, tweede cijferige seconde en 4-cijferige milliseconden). Bijvoorbeeld: 20190627T0840107271.
FileDateTimeUniversal. Een bestand of padvriendelijke weergave van de huidige datum en tijd in universele tijd (UTC), in 24-uursnotatie. De notatie is yyyyMMddTHHmmssffffZ (hoofdlettergevoelig, met behulp van een jaar van 4 cijfers, maand met 2 cijfers, dag van 2 cijfers, de letter T als tijdscheidingsteken, 2-cijferig uur, 2-cijferige minuut, 2-cijferige seconde, 4-cijferige milliseconden en de letter Z als utc-indicator). Bijvoorbeeld: 20190627T1540500718Z.

Type:	String
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-Hour

Hiermee geeft u het uur op dat wordt weergegeven. Voer een waarde in tussen 0 en 23.

Type:	Int
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-Millisecond

Hiermee geeft u de milliseconden op in de datum. Voer een waarde in tussen 0 en 999.

Deze parameter is geïntroduceerd in PowerShell 3.0.

Type:	Int
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-Minute

Hiermee geeft u de minuut op die wordt weergegeven. Voer een waarde in tussen 0 en 59.

Type:	Int
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-Month

Hiermee geeft u de maand die wordt weergegeven. Voer een waarde in tussen 1 en 12.

Type:	Int
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-Second

Hiermee geeft u de tweede die wordt weergegeven. Voer een waarde in tussen 0 en 59.

Type:	Int
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-UFormat

Geeft de datum en tijd weer in UNIX-indeling. De parameter UFormat voert een tekenreeksobject uit.

UFormat aanduidingen worden voorafgegaan door een procentteken (%), bijvoorbeeld %m, %den %Y. De sectie Notities bevat een tabel met geldige UFormat-aanduidingen.

Wanneer de parameter UFormat wordt gebruikt, krijgt Get-Date alleen de eigenschappen van het DateTime object die nodig zijn om de datum weer te geven. Als gevolg hiervan zijn sommige eigenschappen en methoden van DateTime--objecten mogelijk niet beschikbaar.

Type:	String
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-Year

Hiermee geeft u het jaar op dat wordt weergegeven. Voer een waarde in tussen 1 en 9999.

Type:	Int
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

Invoerwaarden

Pipeline input

Get-Date accepteert pijplijninvoer. Bijvoorbeeld Get-ChildItem | Get-Date.

Uitvoerwaarden

System.DateTime or System.String

Get-Date retourneert een DateTime--object, behalve wanneer de parameters Format en UFormat worden gebruikt. De parameters Format of UFormat retourneren tekenreeksobjecten.

Wanneer een DateTime--object naar een cmdlet wordt verzonden, zoals Add-Content die tekenreeksinvoer verwacht, converteert PowerShell het object naar een Tekenreeks-object.

De methode (Get-Date).ToString() converteert een DateTime--object een tekenreeksobject.

Als u de eigenschappen en methoden van een object wilt weergeven, verzendt u het object omlaag in de pijplijn naar Get-Member. Bijvoorbeeld Get-Date | Get-Member.

Notities

Datum/tijd--objecten hebben een lange- en lange-tijdnotatie voor de landinstelling van het systeem.

De geldige UFormat-aanduidingen worden weergegeven in de volgende tabel:

Opmaakaanduiding	Betekenis	Voorbeeld
`%A`	Dag van de week - volledige naam	Maandag
`%a`	Dag van de week - verkorte naam	Ma
`%B`	Maandnaam - vol	Januari
`%b`	Maandnaam - afgekort	Jan
`%C`	Eeuw	20 voor 2019
`%c`	Datum en tijd - afgekort	Do 27 juni 08:44:18 2019
`%D`	Datum in mm-dd-/jj-notatie	06/27/19
`%d`	Dag van de maand - 2 cijfers	05
`%e`	Dag van de maand - cijfer voorafgegaan door een spatie	<ruimte>5
`%F`	Datum in JJJJ-mm-dd-indeling, gelijk aan %Y-%m-%d (de ISO 8601-datumnotatie)	2019-06-27
`%G`	Hetzelfde als 'Y'
`%g`	Hetzelfde als 'y'
`%H`	Uur in 24-uursnotatie	17
`%h`	Hetzelfde als 'b'
`%I`	Uur in 12-uursnotatie	05
`%j`	Dag van het jaar	1-366
`%k`	Hetzelfde als 'H'
`%l`	Hetzelfde als 'I' (hoofdletter I)	05
`%M`	Notulen	35
`%m`	Maandnummer	06
`%n`	nieuwlijnteken
`%p`	AM of PM
`%R`	Tijd in 24-uursnotatie -no seconden	17:45
`%r`	Tijd in indeling van 12 uur	09:15:36 uur
`%S`	Seconden	05
`%s`	Seconden verstreken sinds 1 januari 1970 00:00:00:00	1150451174.95705
`%t`	Horizontaal tabteken
`%T`	Tijd in 24-uursnotatie	17:45:52
`%U`	Hetzelfde als 'W'
`%u`	Dag van de week - nummer	Maandag = 1
`%V`	Week van het jaar	01-53
`%w`	Hetzelfde als 'u'
`%W`	Week van het jaar	00-52
`%X`	Hetzelfde als 'T'
`%x`	Datum in standaardindeling voor landinstellingen	27-06-19 voor English-US
`%Y`	Jaar in 4-cijferige notatie	2019
`%y`	Jaar in tweecijferige notatie	19
`%Z`	Tijdzone-verschuiving van Universal Time Coördinaat (UTC)	-07

Delen via

Get-Date

Syntaxis

Description

Voorbeelden

Voorbeeld 1: De huidige datum en tijd ophalen

Voorbeeld 2: Elementen van de huidige datum en tijd ophalen

Voorbeeld 3: De datum en tijd ophalen met een .NET-indelingsaanduiding

Voorbeeld 4: De datum en tijd ophalen met een UFormat-aanduiding

Voorbeeld 5: Een datumdag van het jaar ophalen

Voorbeeld 6: Controleren of een datum is aangepast voor zomertijd

Voorbeeld 7: De huidige tijd converteren naar UTC-tijd

Voorbeeld 8: Een tijdstempel maken

Parameters

-Date

-Day

-DisplayHint

-Format

-Hour

-Millisecond

-Minute

-Month

-Second

-UFormat

-Year

Invoerwaarden

Uitvoerwaarden

Notities

Aanvullende resources

Delen via

Get-Date

Syntaxis

Description

Voorbeelden

Voorbeeld 1: De huidige datum en tijd ophalen

Voorbeeld 2: Elementen van de huidige datum en tijd ophalen

Voorbeeld 3: De datum en tijd ophalen met een .NET-indelingsaanduiding

Voorbeeld 4: De datum en tijd ophalen met een UFormat-aanduiding

Voorbeeld 5: Een datumdag van het jaar ophalen

Voorbeeld 6: Controleren of een datum is aangepast voor zomertijd

Voorbeeld 7: De huidige tijd converteren naar UTC-tijd

Voorbeeld 8: Een tijdstempel maken

Parameters

-Date

-Day

-DisplayHint

-Format

-Hour

-Millisecond

-Minute

-Month

-Second

-UFormat

-Year

Invoerwaarden

Uitvoerwaarden

Notities

Verwante koppelingen

Aanvullende resources