Get-Date

Riferimento

Modulo:: Microsoft.PowerShell.Utility

Ottiene la data e l'ora correnti.

Sintassi

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>]

Descrizione

Il Get-Date cmdlet ottiene un oggetto DateTime che rappresenta la data corrente o una data specificata. Get-Date può formattare la data e l'ora in diversi formati .NET e UNIX. È possibile usare Get-Date per generare una stringa di caratteri data o ora e quindi inviare la stringa ad altri cmdlet o programmi.

Get-Date usa le impostazioni cultura del computer per determinare la modalità di formattazione dell'output. Per visualizzare le impostazioni del computer, usare (Get-Culture).DateTimeFormat.

Esempio

Esempio 1: ottenere la data e l'ora correnti

In questo esempio viene Get-Date visualizzata la data e l'ora di sistema correnti. L'output si trova nei formati long-date e long-time.

Get-Date

Tuesday, June 25, 2019 14:53:32

Esempio 2: Ottenere elementi della data e dell'ora correnti

In questo esempio viene illustrato come usare Get-Date per ottenere l'elemento data o ora. Il parametro usa gli argomenti Date, Time o DateTime.

Get-Date -DisplayHint Date

Tuesday, June 25, 2019

Get-Date usa il parametro DisplayHint con l'argomento Date per ottenere solo la data.

Esempio 3: ottenere la data e l'ora con un identificatore di formato .NET

In questo esempio viene usato un identificatore di formato .NET per personalizzare il formato dell'output. L'output è un oggetto String .

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

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

Get-Date usa il parametro Format per specificare diversi identificatori di formato.

Gli identificatori di formato .NET usati in questo esempio sono definiti come segue:

Identificatore	Definizione
`dddd`	Giorno della settimana - nome completo
`MM`	Numero del mese
`dd`	Giorno del mese - 2 cifre
`yyyy`	Anno in formato a 4 cifre
`HH:mm`	Tempo in formato 24 ore -no secondi
`K`	Offset del fuso orario da Coordinate ora universale (UTC)

Per altre informazioni sugli identificatori di formato .NET, vedere Stringhe di formato data e ora personalizzate.

Esempio 4: ottenere la data e l'ora con un identificatore UFormat

In questo esempio vengono usati diversi identificatori di formato UFormat per personalizzare il formato dell'output. L'output è un oggetto String .

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

Tuesday 06/25/2019 16:19 -07

Get-Date usa il parametro UFormat per specificare diversi identificatori di formato.

Gli identificatori di formato UFormat usati in questo esempio sono definiti come segue:

Identificatore	Definizione
`%A`	Giorno della settimana - nome completo
`%m`	Numero del mese
`%d`	Giorno del mese - 2 cifre
`%Y`	Anno in formato a 4 cifre
`%R`	Tempo in formato 24 ore -no secondi
`%Z`	Offset del fuso orario da Coordinate ora universale (UTC)

Per un elenco di identificatori di formato UFormat validi, vedere la sezione Note .

Esempio 5: Ottenere un giorno dell'anno

In questo esempio viene usata una proprietà per ottenere il giorno numerico dell'anno.

Il calendario gregoriano ha 365 giorni, ad eccezione di anni salti che hanno 366 giorni. Ad esempio, il 31 dicembre 2020 è il giorno 366.

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

366

Get-Date usa tre parametri per specificare la data: anno, mese e giorno. Il comando viene eseguito con parentesi in modo che il risultato venga valutato dalla proprietà DayofYear .

Esempio 6: verificare se una data viene modificata per l'ora legale

In questo esempio viene usato un metodo booleano per verificare se una data viene modificata in base all'ora legale.

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

True

Una variabile archivia $DST il risultato di Get-Date. $DST usa il metodo IsDaylightSavingTime per verificare se la data viene modificata per l'ora legale.

Esempio 7: Convertire l'ora corrente in ora UTC

In questo esempio l'ora corrente viene convertita in ora UTC. L'offset UTC per le impostazioni locali del sistema viene usato per convertire l'ora. Una tabella nella sezione Note elenca gli identificatori di formato UFormat validi.

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 usa il parametro UFormat con gli identificatori di formato per visualizzare la data e l'ora di sistema correnti. L'identificatore di formato %Z rappresenta l'offset UTC di -07.

La $Time variabile archivia la data e l'ora correnti del sistema. $Time usa il metodo ToUniversalTime() per convertire l'ora in base all'offset UTC del computer.

Esempio 8: Create un timestamp

In questo esempio un identificatore di formato crea un oggetto String timestamp per un nome di directory. Il timestamp include la data, l'ora e l'offset 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

La $timestamp variabile archivia i risultati di un Get-Date comando. Get-Date usa il parametro Format con l'identificatore di formato minuscolo o per creare un oggetto String timestamp. L'oggetto viene inviato alla pipeline a ForEach-Object. ScriptBlock contiene la variabile che rappresenta l'oggetto $_ pipeline corrente. La stringa timestamp è delimitata da punti sostituiti da punti.

New-Item usa il parametro Path per specificare il percorso per una nuova directory. Il percorso include la $timestamp variabile come nome della directory. Il parametro Type specifica che viene creata una directory.

Parametri

-Date

Specifica una data e un'ora. L'ora è facoltativa e, se non specificata, restituisce 00:00:00.

Immettere la data e l'ora in un formato standard per le impostazioni locali del sistema.

Ad esempio, in inglese statunitense:

Get-Date -Date "6/25/2019 12:30:22" restituisce martedì 25 giugno 2019 12:30:22

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

-Day

Specifica il giorno del mese visualizzato. Immettere un valore compreso tra 1 e 31.

Se il valore specificato è maggiore del numero di giorni in un mese, PowerShell aggiunge il numero di giorni al mese. Ad esempio, Get-Date -Month 2 -Day 31 visualizza il 3 marzo, non il 31 febbraio.

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

-DisplayHint

Determina quali elementi della data e dell'ora visualizzare.

I valori accettati sono i seguenti:

Data: visualizza solo la data
Ora: visualizza solo l'ora
DateTime: visualizza la data e l'ora

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

-Format

Visualizza la data e l'ora nel formato di Microsoft .NET Framework indicato dall'identificatore di formato. Il parametro Format restituisce un oggetto String .

Per un elenco degli identificatori di formato .NET disponibili, vedere Stringhe di formato data e ora personalizzate.

Quando viene usato il parametro Format , Get-Date ottiene solo le proprietà dell'oggetto DateTime necessarie per visualizzare la data. Di conseguenza, alcune proprietà e alcuni metodi degli oggetti DateTime potrebbero non essere disponibili.

A partire da PowerShell 5.0, è possibile usare i formati aggiuntivi seguenti come valori per il parametro Format .

FileDate. Rappresentazione descrittiva del file o del percorso della data corrente nell'ora locale. Il formato è yyyyMMdd (distinzione tra maiuscole e minuscole, usando un anno a 4 cifre, un mese a 2 cifre e un giorno a 2 cifre). Ad esempio: 20190627.
FileDateUniversal. Rappresentazione descrittiva del file o del percorso della data corrente nell'ora UTC (Universal Time). Il formato è yyyyMMddZ (distinzione tra maiuscole e minuscole, usando un anno a 4 cifre, un mese a 2 cifre, un giorno a 2 cifre e la lettera Z come indicatore UTC). Ad esempio: 20190627Z.
FileDateTime. Rappresentazione descrittiva del file o del percorso della data e dell'ora corrente nell'ora locale, in formato di 24 ore. Il formato è yyyyMMddTHHmmssffff (distinzione tra maiuscole e minuscole, usando un anno a 4 cifre, un mese a 2 cifre, un giorno a 2 cifre, la lettera T come separatore temporale, ora a 2 cifre, minuto a 2 cifre, secondo di 2 cifre e millisecondi a 4 cifre). Ad esempio: 20190627T0840107271.
FileDateTimeUniversal. Rappresentazione descrittiva del file o del percorso della data e dell'ora corrente in formato UTC (Universal Time), in formato 24 ore. Il formato è yyyyMMddTHHmmssffffZ (distinzione tra maiuscole e minuscole, usando un anno a 4 cifre, un mese a 2 cifre, un giorno a 2 cifre, la lettera T come separatore temporale, un'ora a 2 cifre, un minuto a 2 cifre, un secondo secondo a 4 cifre e la lettera Z come indicatore UTC). Ad esempio: 20190627T1540500718Z.

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

-Hour

Specifica l'ora visualizzata. Immettere un valore compreso tra 0 e 23.

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

-Millisecond

Specifica i millisecondi nella data. Immettere un valore compreso tra 0 e 999.

Questo parametro è stato introdotto in PowerShell 3.0.

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

-Minute

Specifica il minuto visualizzato. Immettere un valore compreso tra 0 e 59.

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

-Month

Specifica il mese visualizzato. Immettere un valore compreso tra 1 e 12.

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

-Second

Specifica i secondi visualizzati. Immettere un valore compreso tra 0 e 59.

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

-UFormat

Visualizza la data e l'ora nel formato UNIX. Il parametro UFormat restituisce un oggetto stringa.

Gli identificatori UFormat sono preceduti da un segno percentuale (%), ad esempio , %m, %de %Y. La sezione Note contiene una tabella di identificatori UFormat validi.

Quando viene usato il parametro UFormat , Get-Date ottiene solo le proprietà dell'oggetto DateTime necessarie per visualizzare la data. Di conseguenza, alcune proprietà e alcuni metodi degli oggetti DateTime potrebbero non essere disponibili.

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

-Year

Specifica l'anno visualizzato. Immettere un valore compreso tra 1 e 9999.

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

Input

Pipeline input

Get-Date accetta l'input della pipeline. Ad esempio: Get-ChildItem | Get-Date.

Output

System.DateTime or System.String

Get-Date restituisce un oggetto DateTime tranne quando vengono usati i parametri Format e UFormat . I parametri Format o UFormat restituiscono oggetti String .

Quando un oggetto DateTime viene inviato alla pipeline a un cmdlet, ad Add-Content esempio che prevede l'input stringa, PowerShell converte l'oggetto in un oggetto String .

Il metodo (Get-Date).ToString() converte un oggetto DateTime un oggetto String .

Per visualizzare le proprietà e i metodi di un oggetto, inviare l'oggetto alla pipeline a Get-Member. Ad esempio: Get-Date | Get-Member.

Note

Gli oggetti DateTime sono in formati di lunga data e di lunga durata per le impostazioni locali del sistema.

Gli identificatori UFormat validi vengono visualizzati nella tabella seguente:

Identificatore di formato	Significato	Esempio
`%A`	Giorno della settimana - nome completo	Monday
`%a`	Giorno della settimana - nome abbreviato	Mon
`%B`	Nome mese - completo	January
`%b`	Nome mese - abbreviato	Gen
`%C`	Secolo	20 per il 2019
`%c`	Data e ora - abbreviato	Thu Jun 27 08:44:18 2019
`%D`	Data in mm/dd/y formato	06/27/19
`%d`	Giorno del mese - 2 cifre	05
`%e`	Giorno del mese - cifra preceduta da uno spazio	<spazio>5
`%F`	Data in formato YAAA-mm-dd, uguale a %Y-%m-%d (formato di data ISO 8601)	2019-06-27
`%G`	Uguale a 'Y'
`%g`	Uguale a 'y'
`%H`	Ora in formato 24 ore	17
`%h`	Uguale a 'b'
`%I`	Ora in formato 12 ore	05
`%j`	Giorno dell'anno	1-366
`%k`	Uguale a 'H'
`%l`	Uguale a 'I' (maiuscolo I)	05
`%M`	Minuti	35
`%m`	Numero del mese	06
`%n`	carattere newline
`%p`	AM o PM
`%R`	Tempo in formato 24 ore -no secondi	17:45
`%r`	Ora in formato 12 ore	09:15:36
`%S`	Secondi	05
`%s`	Secondi trascorsi dal 1 gennaio 1970 00:00:00	1150451174.95705
`%t`	Carattere di scheda orizzontale
`%T`	Tempo in formato 24 ore	17:45:52
`%U`	Uguale a 'W'
`%u`	Giorno della settimana - numero	Lunedì = 1
`%V`	Settimana dell'anno	01-53
`%w`	Uguale a 'u'
`%W`	Settimana dell'anno	00-52
`%X`	Uguale a 'T'
`%x`	Data in formato standard per le impostazioni locali	06/27/19 per inglese-US
`%Y`	Anno in formato a 4 cifre	2019
`%y`	Anno in formato a 2 cifre	19
`%Z`	Offset del fuso orario da Coordinate ora universale (UTC)	-07

Condividi tramite

Get-Date

Sintassi

Descrizione

Esempio

Esempio 1: ottenere la data e l'ora correnti

Esempio 2: Ottenere elementi della data e dell'ora correnti

Esempio 3: ottenere la data e l'ora con un identificatore di formato .NET

Esempio 4: ottenere la data e l'ora con un identificatore UFormat

Esempio 5: Ottenere un giorno dell'anno

Esempio 6: verificare se una data viene modificata per l'ora legale

Esempio 7: Convertire l'ora corrente in ora UTC

Esempio 8: Create un timestamp

Parametri

-Date

-Day

-DisplayHint

-Format

-Hour

-Millisecond

-Minute

-Month

-Second

-UFormat

-Year

Input

Output

Note

Risorse aggiuntive

Condividi tramite

Get-Date

Sintassi

Descrizione

Esempio

Esempio 1: ottenere la data e l'ora correnti

Esempio 2: Ottenere elementi della data e dell'ora correnti

Esempio 3: ottenere la data e l'ora con un identificatore di formato .NET

Esempio 4: ottenere la data e l'ora con un identificatore UFormat

Esempio 5: Ottenere un giorno dell'anno

Esempio 6: verificare se una data viene modificata per l'ora legale

Esempio 7: Convertire l'ora corrente in ora UTC

Esempio 8: Create un timestamp

Parametri

-Date

-Day

-DisplayHint

-Format

-Hour

-Millisecond

-Minute

-Month

-Second

-UFormat

-Year

Input

Output

Note

Collegamenti correlati

Risorse aggiuntive