Ottiene la data e l'ora correnti.

Sintassi

Get-Date [-Formato <string>] [[-Data] <DateTime>] [-Day <int>] [-DisplayHint {<Date> | <Time> | <DateTime>}] [-Hour <int>] [-Minute <int>] [-Month <int>] [-Second <int>] [-Year <int>] [<CommonParameters>]

Get-Date [-UFormat <string>] [[-Data] <DateTime>] [-Day <int>] [-DisplayHint {<Date> | <Time> | <DateTime>}] [-Hour <int>] [-Minute <int>] [-Month <int>] [-Second <int>] [-Year <int>] [<CommonParameters>]

Descrizione

Il cmdlet Get-Date consente di ottenere un oggetto DateTime che rappresenta la data corrente o una data specificata dall'utente. La data e l'ora possono essere formattate in diversi formati Windows e UNIX. È possibile utilizzare Get-Date per generare una stringa di caratteri data o ora e inviare quindi la stringa ad altri cmdlet o programmi.

Parametri

-Data <DateTime>

Specifica una data e un'ora. Per impostazione predefinita, Get-Date consente di ottenere la data e l'ora correnti del sistema.

Digitare la data in un formato standard per le impostazioni locali del sistema, ad esempio gg-MM-aaaa (tedesco [Germania]) o MM/gg/aaaa (inglese [Stati Uniti]).

Obbligatorio?

false

Posizione?

1

Valore predefinito

Accettare input da pipeline?

true (ByValue, ByPropertyName)

Accettare caratteri jolly?

false

-Day <int>

Specifica il giorno del mese visualizzato. Immettere un valore compreso tra 1 e 31. Tale valore verrà visualizzato in sostituzione del giorno corrente.

Se si specifica un valore maggiore del numero di giorni del mese, il numero di giorni verrà aggiunto al mese e verrà visualizzata la data risultante. Ad esempio, se si specifica "get-date -month 2 -day 31", verrà visualizzato "3 marzo" e non "31 febbraio".

Obbligatorio?

false

Posizione?

named

Valore predefinito

Accettare input da pipeline?

false

Accettare caratteri jolly?

false

-DisplayHint <DisplayHintType>

Determina gli elementi della data e dell'ora che vengono visualizzati.

I valori validi sono:

-- Date: visualizza solo la data

-- Time: visualizza solo l'ora

-- DateTime: visualizza la data e l'ora

Il valore predefinito è DateTime.

Questo parametro non influisce sull'oggetto DateTime recuperato da Get-Date.

Obbligatorio?

false

Posizione?

named

Valore predefinito

Accettare input da pipeline?

false

Accettare caratteri jolly?

false

-Formato <string>

Visualizza la data e l'ora nel formato Microsoft .NET Framework indicato dall'identificatore di formato. Immettere un identificatore di formato. Per un elenco identificatori di formato disponibili, vedere l'argomento relativo alla classe DateTimeFormatInfo in MSDN (Microsoft Developer Network) Library all'indirizzo https://go.microsoft.com/fwlink/? LinkId=143638 (le informazioni potrebbero essere in lingua inglese).

Quando si utilizza il parametro Format, in Windows PowerShell vengono recuperate solo le proprietà dell'oggetto DateTime necessarie per visualizzare la data nel formato specificato. Di conseguenza, è possibile che alcune proprietà e alcuni metodi degli oggetti DateTime non siano disponibili.

Obbligatorio?

false

Posizione?

named

Valore predefinito

Accettare input da pipeline?

false

Accettare caratteri jolly?

false

-Hour <int>

Specifica l'ora visualizzata. Immettere un valore compreso tra 1 e 23. Tale valore verrà visualizzato in sostituzione dell'ora corrente.

Obbligatorio?

false

Posizione?

named

Valore predefinito

Accettare input da pipeline?

false

Accettare caratteri jolly?

false

-Minute <int>

Specifica il minuto visualizzato. Immettere un valore compreso tra 1 e 59. Tale valore verrà visualizzato in sostituzione del minuto corrente.

Obbligatorio?

false

Posizione?

named

Valore predefinito

Accettare input da pipeline?

false

Accettare caratteri jolly?

false

-Month <int>

Specifica il mese visualizzato. Immettere un valore compreso tra 1 e 12. Tale valore verrà visualizzato in sostituzione del mese corrente.

Obbligatorio?

false

Posizione?

named

Valore predefinito

Accettare input da pipeline?

false

Accettare caratteri jolly?

false

-Second <int>

Specifica il secondo visualizzato. Immettere un valore compreso tra 1 e 59. Tale valore verrà visualizzato in sostituzione del secondo corrente.

Obbligatorio?

false

Posizione?

named

Valore predefinito

Accettare input da pipeline?

false

Accettare caratteri jolly?

false

-UFormat <string>

Visualizza la data e l'ora in formato UNIX. Per un elenco degli identificatori di formato, vedere la sezione Note.

Quando si utilizza il parametro UFormat, in Windows PowerShell vengono recuperate solo le proprietà dell'oggetto DateTime necessarie per visualizzare la data nel formato specificato. Di conseguenza, è possibile che alcune proprietà e alcuni metodi degli oggetti DateTime non siano disponibili.

Obbligatorio?

false

Posizione?

named

Valore predefinito

Accettare input da pipeline?

false

Accettare caratteri jolly?

false

-Year <int>

Specifica l'anno visualizzato. Immettere un valore compreso tra 1 e 9999. Tale valore verrà visualizzato in sostituzione dell'anno corrente.

Obbligatorio?

false

Posizione?

named

Valore predefinito

Accettare input da pipeline?

false

Accettare caratteri jolly?

false

<CommonParameters>

Questo cmdlet supporta i parametri comuni -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer e -OutVariable. Per ulteriori informazioni, vedere about_Commonparameters.

Input e output

Il tipo di input è il tipo degli oggetti che è possibile reindirizzare al cmdlet. Il tipo restituito è il tipo degli oggetti restituiti dal cmdlet.

Input

Nessuno

Non è possibile reindirizzare l'input a questo cmdlet.

Output

System.DateTime o System.String

Quando si utilizzano i parametri Format o UFormat, l'oggetto di output è System.String.

Note

Per impostazione predefinita, la data e l'ora vengono visualizzate nei formati di data e ora estesi per le impostazioni locali del sistema.

Quando si reindirizza una data ai cmdlet che prevedono un input di tipo stringa, ad esempio Add-Content, in Windows PowerShell l'oggetto DateTime viene convertito in una stringa prima di essere aggiunto al file. Il formato ToString () predefinito è in formato breve per la data ed esteso per l'ora. Per specificare un formato alternativo, utilizzare i parametri Format o UFormat di Get-Date.

Valori di Uformat

Di seguito sono riportati i valori del parametro UFormat. Il formato del comando è:

get-date -uformat %<valore>

Ad esempio,

get-date - uformat%d

Date-Time:

Data e ora - formato esteso

(impostazione predefinita) (venerdì 16 giugno 2006 10.31.27)

c Data e ora - formato breve (ven 16 giu 2006 10.31.27)

Data:

D Data in formato mm/gg/aa (06/14/06)

x Data nel formato standard per le impostazioni internazionali (12/09/2007 per l'italiano)

Anno:

C Secolo (20 per il 2006)

Y Anno nel formato a quattro cifre (2006)

y Anno nel formato a due cifre (06)

G Uguale a 'Y'

g Uguale a 'y'

Mese:

b Nome del mese - formato breve (gen)

B Nome del mese - formato lungo (gennaio)

h Uguale a 'b'

m Numero del mese (06)

Settimana:

W Settimana dell'anno (da 00 a 52)

V Settimana dell'anno (da 01 a 53)

U Uguale a 'W'

Giorno:

a Giorno della settimana - formato breve (lun)

A Giorno della settimana - formato esteso (lunedì)

u Giorno della settimana - numero (lunedì = 1)

d Giorno del mese - Due cifre (05)

e Giorno del mese - cifra preceduta da uno spazio ( 5)

j Giorno dell'anno - (da 1 a 366)

w Uguale a 'u'

Orario:

p AM o PM

r Orario nel formato 12 ore (09:15:36 AM)

R Orario nel formato 24 ore - senza secondi (17:45)

T Orario nel formato 24 ore (17:45:52)

X Uguale a 'T'

Z Differenza di fuso orario da UTC (-07)

Ora:

H Ora nel formato 24 ore (17)

I Ora nel formato 12 ore (05)

k Uguale a 'H'

l Uguale a 'I' (I maiuscola = L minuscola)

Minuti e secondi:

M Minuti (35)

S Secondi (05)

s Secondi trascorsi dal 1 gennaio 1970 00.00.00 (1150451174.95705)

Caratteri speciali:

n carattere di avanzamento riga (\n)

t carattere di tabulazione (\t)

Esempio 1

C:\PS>get-date -DisplayHint date

Tuesday, June 13, 2006

Descrizione
-----------
Tramite questo comando verrà recuperato un oggetto DateTime, ma verrà visualizzata solo la data. Per indicare che deve essere visualizzata solo la data, verrà utilizzato il parametro DisplayHint.






Esempio 2

C:\PS>get-date -format g

6/13/2006 12:43 PM

Descrizione
-----------
Tramite questo comando la data e l'ora corrente verranno recuperate e formattate entrambe nel formato breve. Per specificare il formato, verrà utilizzato l'identificatore di formato "g" di .NET Framework, ovvero Generale per specifica della data e dell'ora in formato breve.






Esempio 3

C:\PS>get-date -uformat "%Y / %m / %d / %A / %Z"

2006 / 06 / 13 / Tuesday / -07

Descrizione
-----------
Tramite questo comando la data e l'ora corrente verranno recuperate e formattate nel modo specificato dal comando. In questo caso, saranno inclusi l'anno espresso nel formato esteso (%Y), il mese espresso in formato numerico a due cifre (%m), la data (%d), il giorno della settimana espresso nel formato esteso (%A) e la differenza di fuso orario rispetto a UTC ("Zulu").






Esempio 4

C:\PS>(get-date -year 2000 -month 12 -day 31).dayofyear

366

Descrizione
-----------
Tramite questo comando verrà visualizzato il giorno dell'anno corrispondente alla data corrente. Ad esempio, il 31 dicembre corrisponde al trecentosessantacinquesimo giorno del 2006, ma è il trecentosessantaseiesimo giorno del 2000.






Esempio 5

C:\PS>$a = get-date

C:\PS> $a.IsDaylightSavingTime()

True

Descrizione
-----------
Tramite questi comandi verrà indicato se la data e l'ora correnti sono regolate per l'ora legale nelle impostazioni internazionali correnti. 

Tramite il primo comando verrà creata una variabile denominata $a, cui verrà assegnato l'oggetto recuperato da Get-Date. Verrà quindi utilizzato il metodo IsDaylightSavingTime sull'oggetto presente nella variabile $a.

Per visualizzare le proprietà e i metodi dell'oggetto DateTime, digitare:
 "get-date | get-member".






Esempio 6

C:\PS>$a = get-date

C:\PS> $a.ToUniversalTime()

Tuesday, June 13, 2006 8:09:19 PM

Descrizione
-----------
Tramite questi comandi la data e l'ora correnti verranno convertiti nell'ora UTC.

Tramite il primo comando verrà creata una variabile denominata $a, cui verrà assegnato l'oggetto recuperato da Get-Date. Verrà quindi utilizzato il metodo ToUniversalTime sull'oggetto presente nella variabile $a.






Esempio 7

C:\PS>$a = get-wmiobject win32_bios -computer server01

$a | format-list -property Name, @{Label="BIOS Age"; `
Expression={(get-date) - $_.ConvertToDateTime($_.ReleaseDate)}}

Name     : Default System BIOS
BIOS Age : 1345.17:31:07.1091047

Descrizione
-----------
In Strumentazione gestione Windows (WMI) viene utilizzato un oggetto data/ora diverso dall'oggetto data/ora di .NET Framework restituito da Get-Date. Per utilizzare le informazioni relative a data e ora restituite da WMI in un comando in cui tali informazioni vengono restituite da Get-Date, è necessario utilizzare il metodo ConvertToDateTime per convertire gli oggetti CIM_DATETIME di WMI in oggetti DateTime di .NET Framework.

Con i comandi di questo esempio vengono visualizzati il nome e l'età del BIOS in un computer remoto, Server01. 

Nel primo comando viene utilizzato il cmdlet Get-WmiObject per ottenere un'istanza della classe Win32_BIOS in Server01 che viene archiviata nella variabile $a.

Nel secondo comando viene utilizzato l'operatore pipeline (|) per inviare l'oggetto WMI archiviato in $a al cmdlet Format-List. Viene quindi utilizzato il parametro Property di Format-List per specificare due proprietà da visualizzare nell'elenco, ovvero "Name" e "BIOS Age". La proprietà "BIOS Age" viene specificata in una tabella hash. Tale tabella include la chiave Label, in cui è specificato il nome della proprietà, e la chiave Expression, che include l'espressione per il calcolo dell'età del BIOS. Nell'espressione viene utilizzato il metodo ConvertToDateTime per convertire ogni istanza di ReleaseDate in un oggetto DateTime di .NET Framework. Il valore viene quindi sottratto da quello del cmdlet Get-Date, che, senza parametri, consente di ottenere la data corrente.

Il carattere di apice inverso (`) è il carattere di continuazione della riga in Windows PowerShell.






Esempio 8

C:\PS>get-date

Tuesday, June 13, 2006 12:43:42 PM

Descrizione
-----------
Con questo comando si ottiene un oggetto DateTime e vengono visualizzate la data e l'ora correnti nei formati estesi di data e ora per le impostazioni locali del sistema, come per il comando "get-date -format F".






Esempio 9

C:\PS>get-date

C:\PS> Tuesday, September 26, 2006 11:25:31 AM

c:\PS>(get-date).ToString()
9/26/2006 11:25:31 AM

C:\PS>get-date | add-content test.txt  
# Adds 9/26/2006 11:25:31 AM

C:\PS>get-date -format F | add-content test.txt
# Adds Tuesday, September 26, 2006 11:25:31 AM

Descrizione
-----------
Con questi comandi viene illustrato come utilizzare Get-Date con Add-Content e altri cmdlet che convertono in una stringa l'oggetto DateTime generato da Get-Date.

Nel primo comando viene illustrato che la visualizzazione predefinita da un comando "get-date" è in formato di data e ora esteso.

Nel secondo comando viene illustrato che la visualizzazione predefinita dal metodo ToString() dell'oggetto DateTime è in formato di data e ora breve.

Nel terzo comando viene utilizzato un operatore pipeline per inviare l'oggetto DateTime al cmdlet Add-Content che aggiunge il contenuto al file Test.txt. Poiché Add-Content utilizza il metodo ToString () dell'oggetto DateTime, la data aggiunta è in formato di data e ora breve.

Nel quarto comando viene utilizzato il parametro Format di Get-Date per specificare il formato. Quando si utilizzano i parametri Format o UFormat, Get-Date genera una stringa, non un oggetto DateTime. Successivamente, quando la stringa viene inviata a Add-Content, viene aggiunta al file Test.txt senza modifiche.






Vedere anche




Argomenti della Guida