Get-Date
Ottiene la data e l'ora correnti.
Sintassi
net (Impostazione predefinita)
Get-Date
[[-Date] <datetime>]
[-Year <int>]
[-Month <int>]
[-Day <int>]
[-Hour <int>]
[-Minute <int>]
[-Second <int>]
[-Millisecond <int>]
[-DisplayHint <DisplayHintType>]
[-Format <string>]
[<CommonParameters>]
UFormat
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 cmdlet Get-Date ottiene un oggetto DateTime che rappresenta la data corrente o una data specificata.
Get-Date possibile 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 Utilizza 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 Get-Date visualizza 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 di data o ora. Il parametro usa gli argomenti Date, Timeo 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 mese |
dd |
Giorno del mese - 2 cifre |
yyyy |
Anno in formato a 4 cifre |
HH:mm |
Tempo in formato 24 ore -no secondi |
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 mese |
%d |
Giorno del mese - 2 cifre |
%Y |
Anno in formato a 4 cifre |
%R |
Tempo in formato 24 ore -no secondi |
%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: Year, Monthe Day. Il comando viene eseguito con parentesi in modo che il risultato venga valutato dalla proprietà DayofYear.
Esempio 6: Verificare se una data è regolata per l'ora legale
In questo esempio viene utilizzato un metodo booleano per verificare se una data viene regolata in base all'ora legale.
$DST = Get-Date
$DST.IsDaylightSavingTime()
True
Una variabile $DST archivia il risultato di Get-Date.
$DST utilizza il metodo IsDaylightSavingTime per verificare se la data è regolata 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 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 variabile $Time archivia la data e l'ora di sistema correnti.
$Time utilizza il metodo ToUniversalTime() 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 timestamp oggetto String 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 variabile $timestamp archivia i risultati di un comando Get-Date.
Get-Date usa il parametro Format con l'identificatore di formato del o minuscolo per creare un timestamp oggetto String. L'oggetto viene inviato alla pipeline a ForEach-Object. Un 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 variabile $timestamp 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 degli Stati Uniti:
Get-Date -Date "6/25/2019 12:30:22" ritorna Martedì, 25 Giu 2019 12:30:22
Proprietà dei parametri
| Tipo: | DateTime |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
| Alias: | LastWriteTime (data e ora dell'ultima modifica) |
Set di parametri
(All)
| Posizione: | 0 |
| Obbligatorio: | False |
| Valore dalla pipeline: | True |
| Valore dalla pipeline in base al nome della proprietà: | True |
| Valore dagli argomenti rimanenti: | 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 viene visualizzato il 3 marzo, non il 31 febbraio.
Proprietà dei parametri
| Tipo: | Int |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-DisplayHint
Determina quali elementi della data e dell'ora vengono visualizzati.
I valori accettati sono i seguenti:
- Data: visualizza solo la data
- Tempo: visualizza solo l'ora
- DateTime: visualizza la data e l'ora
Proprietà dei parametri
| Tipo: | DisplayHintType |
| Valore predefinito: | None |
| Valori accettati: | Date, Time, DateTime |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-Format
Visualizza la data e l'ora nel formato 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 di data e ora personalizzate.
Quando si utilizza il parametro Format, Get-Date ottiene solo le proprietà dell'oggetto DateTime necessarie per visualizzare la data. Di conseguenza, alcune proprietà e metodi di 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(con 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 in formato UTC (Universal Time). Il formato è
yyyyMMddZ(con distinzione tra maiuscole e minuscole, usando un anno a 4 cifre, un mese a 2 cifre, un giorno a 2 cifre e la letteraZcome indicatore UTC). Ad esempio: 20190627Z.FileDateTime. Rappresentazione descrittiva del file o del percorso della data e dell'ora correnti 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, una letteraTcome separatore di tempo, un'ora a 2 cifre, un minuto a 2 cifre, un secondo a 2 cifre e un millisecondo a 4 cifre). Ad esempio: 20190627T0840107271.FileDateTimeUniversal. Rappresentazione di file o percorso della data e dell'ora correnti in formato UTC (Universal Time), in formato 24 ore. Il formato è
yyyyMMddTHHmmssffffZ(con distinzione tra maiuscole e minuscole, usando un anno a 4 cifre, un mese a 2 cifre, un giorno a 2 cifre, un giorno a 2 cifreT, un giorno a 2 cifre, un giorno a 2 cifre, un millisecondo a 4 cifre e la letteraZcome indicatore UTC). Ad esempio: 20190627T1540500718Z.
Proprietà dei parametri
| Tipo: | String |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
net
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-Hour
Specifica l'ora visualizzata. Immettere un valore compreso tra 0 e 23.
Proprietà dei parametri
| Tipo: | Int |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-Millisecond
Specifica i millisecondi nella data. Immettere un valore compreso tra 0 e 999.
Questo parametro è stato introdotto in PowerShell 3.0.
Proprietà dei parametri
| Tipo: | Int |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-Minute
Specifica il minuto visualizzato. Immettere un valore compreso tra 0 e 59.
Proprietà dei parametri
| Tipo: | Int |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-Month
Specifica il mese visualizzato. Immettere un valore compreso tra 1 e 12.
Proprietà dei parametri
| Tipo: | Int |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-Second
Specifica il secondo visualizzato. Immettere un valore compreso tra 0 e 59.
Proprietà dei parametri
| Tipo: | Int |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-UFormat
Visualizza la data e l'ora in formato UNIX. Il parametro UFormat restituisce un oggetto stringa.
identificatori di UFormat sono preceduti da un segno di percentuale (%), ad esempio %m, %de %Y. La sezione Note contiene una tabella di identificatori UFormat validi .
Quando viene utilizzato il parametro UFormat, Get-Date ottiene solo le proprietà dell'oggetto DateTime necessarie per visualizzare la data. Di conseguenza, alcune proprietà e metodi di oggetti DateTime potrebbero non essere disponibili.
Proprietà dei parametri
| Tipo: | String |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
UFormat
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-Year
Specifica l'anno visualizzato. Immettere un valore compreso tra 1 e 9999.
Proprietà dei parametri
| Tipo: | Int |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
CommonParameters
Questo cmdlet supporta i parametri comuni: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Per altre informazioni, vedi about_CommonParameters.
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 utilizzati 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 esempio Add-Content che prevede l'input stringa, PowerShell converte l'oggetto in un oggetto string .
Il metodo (Get-Date).ToString() converte un oggetto DateTime in un oggetto String .
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.
Note
Gli oggetti DateTime sono in formato long-date e long-time 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 | 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 - cifra preceduta da uno spazio | spazio <>5 |
%F |
Data in formato AAAA-mm-dd, uguale a %Y-%m-%d (formato 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 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 | 1150451174.95705 |
%t |
Carattere di tabulazioni orizzontali | |
%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 | 27/06/19 per English-US |
%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 |