Get-Date

Sintassi

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

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 di data o ora e quindi inviare la stringa ad altri cmdlet o programmi.

Get-Date usa le impostazioni cultura correnti del sistema operativo per determinare la 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 - nessun secondo
K	Differenza di fuso orario dalla coordinata ora universale (UTC)

Per altre informazioni sugli identificatori di formato .NET, vedere Stringhe di formato di 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 - nessun secondo
%Z	Differenza di fuso orario dalla coordinata ora universale (UTC)

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

Esempio 5: Ottenere il giorno di una data dell'anno

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

Il calendario gregoriano ha 365 giorni, ad eccezione degli anni bisestili con 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 sottoposto a wrapping tra parentesi in modo che il risultato venga valutato dalla proprietà DayofYear .

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

In questo esempio viene utilizzato 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 Notes 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 di sistema correnti. $Time utilizza il ToUniversalTime() metodo per convertire l'ora in base all'offset UTC del computer.

Esempio 8: Creare 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-Dateusa 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 due punti che vengono sostituiti da punti.

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

Esempio 9: Convertire un timestamp Unix

Questo esempio converte un'ora Unix (rappresentata dal numero di secondi dal 1970-01-01 01 0:00:00) a DateTime.

Get-Date -UnixTimeSeconds 1577836800

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

Esempio 10: Restituire un valore di data interpretato come UTC

In questo esempio viene illustrato come interpretare un valore di data come equivalente UTC. Ad esempio, questo computer è impostato su Pacific Standard Time. Per impostazione predefinita, restituisce Get-Date i valori per il fuso orario. Usare il parametro AsUTC per convertire il valore nell'ora UTC equivalente.

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

Esempio 11: Mostra impostazioni cultura invarianti

ToString() Converte un oggetto DateTime in string utilizzando l'impostazione delle impostazioni cultura correnti. Tuttavia, l'interpretazione delle espressioni di PowerShell usa sempre l'impostazione delle impostazioni cultura invarianti.

Ad esempio, in un sistema con le en-US impostazioni cultura, il ToString() metodo formatta la data usando le en-US impostazioni cultura.

# 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

Parametri

-AsUTC

-Date

-Day

-DisplayHint

-Format

-Hour

-Millisecond

-Minute

-Month

-Second

-UFormat

-UnixTimeSeconds

-Year

Input

DateTime

È possibile inviare tramite pipe un oggetto DateTime a questo cmdlet.

Output

DateTime

Per impostazione predefinita, questo cmdlet restituisce un oggetto DateTime .

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

ToString() Converte un oggetto DateTime in un valore String utilizzando l'impostazione delle impostazioni cultura correnti. Tuttavia, l'interpretazione delle espressioni di PowerShell usa sempre l'impostazione delle impostazioni cultura invarianti. Per vedere come le impostazioni cultura invarianti sono diverse, vedere l'esempio 11.

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

String

Quando si usano i parametri Format o UFormat , questo cmdlet restituisce oggetti String .

Note

I formati predefiniti per l'output degli oggetti DateTime sono formati di data e ora estesa per le impostazioni locali attualmente selezionate.

Gli identificatori UFormat validi vengono visualizzati nella tabella seguente:

Identificatore di formato	Significato	Esempio
%A	Giorno della settimana - nome completo	lunedì
%a	Giorno della settimana - nome abbreviato	Lun
%B	Nome mese - completo	Gennaio
%b	Nome mese - abbreviato	Jan
%C	Secolo	20 per il 2019
%c	Data e ora - abbreviato	Gio 27 giugno 08:44:18 2019
%D	Data in formato mm/gg/yy	06/27/19
%d	Giorno del mese - 2 cifre	05
%e	Giorno del mese - preceduto da uno spazio se solo una singola cifra	<spazio>5
%F	Data in formato AAAA-mm-gg, uguale a %Y-%m-%d (formato data ISO 8601)	27-06-2019
%G	Anno di data settimana ISO (anno contenente giovedì della settimana)
%g	Uguale a 'G' - 2 cifre
%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 di nuova riga
%p	AM o PM
%R	Tempo in formato 24 ore -no secondi	17:45
%r	Tempo in formato 12 ore	09:15:36
%S	Secondi	05
%s	Secondi trascorsi dal 1° gennaio 1970 00:00:00 (UTC)	1150451174
%t	Carattere di tabulazioni orizzontali
%T	Tempo in formato 24 ore	17:45:52
%U	Uguale a 'W'
%u	Giorno numerico della settimana (1-7) (modificato in PowerShell 7.2)	Lunedì = 1, domenica = 7
%V	Settimana dell'anno	01-53
%w	Giorno numerico della settimana (0-6)	Domenica = 0, sabato = 6
%W	Settimana dell'anno	00-52
%X	Uguale a 'T'
%x	Data in formato standard per le impostazioni locali	27/06/19 per Inglese-Stati Uniti
%Y	Anno in formato a 4 cifre	2019
%y	Anno in formato a 2 cifre	19
%Z	Differenza di fuso orario dalla coordinata ora universale (UTC)	-07

Collegamenti correlati

• ForEach-Object
• Get-Culture
• Get-Member
• New-Item
• New-TimeSpan
• Set-Date
• Impostazioni cultura