Get-Date

Obtient l'heure et la date actuelles.

Syntaxe

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

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

Description

L'applet de commande Get-Date obtient un objet DateTime qui représente la date du jour ou une date que vous spécifiez. Elle peut mettre en forme la date et l'heure dans plusieurs formats d'UNIX et Windows. Vous pouvez utiliser Get-Date pour générer une chaîne de caractères de date ou d'heure, puis envoyer cette chaîne à d'autres applets de commande ou programmes.

Paramètres

-Date <DateTime>

Spécifie une date et une heure. Par défaut, Get-Date obtient la date et l'heure actuelles du système.

Tapez la date dans un format standard des paramètres régionaux système, tel que jj-mm-aaaa (allemand [Allemagne]) ou MM/jj/aaaa (Anglais [États-Unis]).

Obligatoire ?

false

Position ?

1

Valeur par défaut

Accepter l'entrée de pipeline ?

true (ByValue, ByPropertyName)

Accepter les caractères génériques ?

false

-Day <int>

Spécifie le jour du mois qui est affiché. Entrez une valeur comprise entre 1 et 31. Cette valeur est affichée à la place du jour actuel.

Si vous spécifiez une valeur qui est supérieure au nombre de jours dans le mois, Windows PowerShell ajoute le nombre de jours au mois et affiche le résultat. Par exemple, « get-date -month 2 -day 31 » affiche le « 3 mars », pas le « 31 février ».

Obligatoire ?

false

Position ?

named

Valeur par défaut

Accepter l'entrée de pipeline ?

false

Accepter les caractères génériques ?

false

-DisplayHint <DisplayHintType>

Détermine quels éléments de la date et de l'heure qui sont affichés.

Les valeurs valides sont :

-- Date : affiche uniquement la date

-- Time : affiche uniquement l'heure

-- DateTime : affiche la date et l'heure

La valeur par défaut est DateTime.

Ce paramètre n'affecte pas l'objet DateTime que Get-Date récupère.

Obligatoire ?

false

Position ?

named

Valeur par défaut

Accepter l'entrée de pipeline ?

false

Accepter les caractères génériques ?

false

-Format <string>

Affiche la date et l'heure dans le format Microsoft .NET Framework indiqué par le spécificateur de format. Entrez un spécificateur de format. Pour une liste de spécificateurs de format disponibles, consultez la rubrique « Classe DateTimeFormatInfo » (page éventuellement en anglais) de la bibliothèque MSDN (Microsoft Developer Network) à l'adresse http://go.microsoft.com/fwlink/?LinkId=143638.

Lorsque vous utilisez le paramètre Format, Windows PowerShell récupère uniquement les propriétés de l'objet DateTime dont il a besoin pour afficher la date au format que vous spécifiez. En conséquence, certaines propriétés et méthodes d'objets DateTime peuvent ne pas être disponibles.

Obligatoire ?

false

Position ?

named

Valeur par défaut

Accepter l'entrée de pipeline ?

false

Accepter les caractères génériques ?

false

-Hour <int>

Spécifie l'heure qui est affichée. Entrez une valeur comprise entre 1 et 23. Cette valeur est affichée à la place de l'heure actuelle.

Obligatoire ?

false

Position ?

named

Valeur par défaut

Accepter l'entrée de pipeline ?

false

Accepter les caractères génériques ?

false

-Minute <int>

Spécifie la minute qui est affichée. Entrez une valeur comprise entre 1 et 59. Cette valeur est affichée à la place de la minute actuelle.

Obligatoire ?

false

Position ?

named

Valeur par défaut

Accepter l'entrée de pipeline ?

false

Accepter les caractères génériques ?

false

-Month <int>

Spécifie le mois qui est affiché. Entrez une valeur comprise entre 1 et 12. Cette valeur est affichée à la place du mois actuel.

Obligatoire ?

false

Position ?

named

Valeur par défaut

Accepter l'entrée de pipeline ?

false

Accepter les caractères génériques ?

false

-Second <int>

Spécifie la seconde qui est affichée. Entrez une valeur comprise entre 1 et 59. Cette valeur est affichée à la place de la seconde actuelle.

Obligatoire ?

false

Position ?

named

Valeur par défaut

Accepter l'entrée de pipeline ?

false

Accepter les caractères génériques ?

false

-UFormat <string>

Affiche la date et l'heure au format UNIX. Pour une liste de spécificateurs de format, consultez la section Remarques.

Lorsque vous utilisez le paramètre UFormat, Windows PowerShell récupère uniquement les propriétés de l'objet DateTime dont il a besoin pour afficher la date au format que vous spécifiez. En conséquence, certaines propriétés et méthodes d'objets DateTime peuvent ne pas être disponibles.

Obligatoire ?

false

Position ?

named

Valeur par défaut

Accepter l'entrée de pipeline ?

false

Accepter les caractères génériques ?

false

-Year <int>

Spécifie l'année qui est affichée. Entrez une valeur comprise entre 1 et 9999. Cette valeur est affichée à la place de l'année actuelle.

Obligatoire ?

false

Position ?

named

Valeur par défaut

Accepter l'entrée de pipeline ?

false

Accepter les caractères génériques ?

false

<CommonParameters>

Cette applet de commande prend en charge les paramètres courants : -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer et -OutVariable. Pour plus d'informations, consultez about_Commonparameters.

Entrées et sorties

Le type d'entrée est le type des objets que vous pouvez diriger vers l'applet de commande. Le type de retour est le type des objets que l'applet de commande retourne.

Entrées

Aucun

Vous ne pouvez pas diriger d'entrée vers cette applet de commande.

Sorties

System.DateTime ou System.String

Lorsque vous utilisez les paramètres Format ou UFormat, l'objet de sortie est System.String.

Remarques

Par défaut, la date et l'heure sont affichées au format de date et d'heure long des paramètres régionaux système.

Lorsque vous dirigez une date vers des applets de commande qui attendent une entrée de chaîne, telles que Add-Content, Windows PowerShell convertit l'objet DateTime en une chaîne avant de l'ajouter au fichier. Le format ToString() par défaut est date courte et heure longue. Pour spécifier un autre format, utilisez les paramètres Format ou UFormat de Get-Date.

Valeurs Uformat :

Les éléments suivants sont les valeurs du paramètre Uformat. Le format pour la commande est :

get-date -uformat %<valeur>

Par exemple :

get-date -uformat %d

Date-Time :

Date et heure – format complet

(par défaut) (vendredi 16 juin 2006 10:31:27)

c Date et heure - format abrégé (ven 16 jun 2006 10:31:27)

Date :

D Date au format jj/mm/aa (14/06/06)

x Date au format standard pour les paramètres régionaux (09/12/07 pour Anglais des É.-U.)

Année :

C Siècle (20 pour 2006)

Y Année dans un format à 4 chiffres (2006)

y Année dans un format à 2 chiffres (06)

G Identique à « Y »

g Identique à « y »

Mois :

b Nom du mois - abrégé (jan)

B Nom du mois - complet (janvier)

h Identique à « b »

m Numéro du mois (06)

Semaine :

W Semaine de l'année (00-52)

V Semaine de l'année (01-53)

U…Identique à « W »

Jour :

a Jour de la semaine - nom abrégé (lun)

A Jour de la semaine - nom complet (lundi)

u Jour de la semaine - nombre (lundi = 1)

d Jour du mois – 2 chiffres (05)

e Jour du mois - chiffre précédé d'un espace ( 5)

j Jour de l'année - (1-366)

w Identique à « u »

Heure :

p Matin ou après-midi

r L'heure au format 12 heures (09:15:36 AM)

R L'heure au format 24 heures - aucune seconde (17:45)

T Heure au format 24 heures (17:45:52)

X Identique à « T »

Z Décalage de fuseau horaire par rapport au Temps universel coordonné (UTC) (-07)

Heure :

H Heure au format 24 heures (17)

I Heure au format 12 heures (05)

k Identique à « H »

l Identique à « I » (I majuscule = L minuscule)

Minutes et secondes :

M Minutes (35)

S Secondes (05)

s Secondes écoulées depuis le 1er janvier 1970 à 00:00:00 (1150451174.95705)

Caractères spéciaux :

n Caractère de nouvelle ligne (\n)

t Caractère de tabulation (\t)

Exemple 1

C:\PS>get-date -DisplayHint date

Tuesday, June 13, 2006

Description
-----------
Cette commande récupère un objet DateTime, mais affiche uniquement la date. Elle utilise le paramètre DisplayHint pour indiquer que seule la date sera affichée.





Exemple 2

C:\PS>get-date -format g

6/13/2006 12:43 PM

Description
-----------
Cette commande récupère la date et l'heure actuelles et les met en forme selon un format court. Elle utilise le spécificateur de format « g » .NET Framework ([date courte et heure courte] général) pour spécifier le format.





Exemple 3

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

2006 / 06 / 13 / Tuesday / -07

Description
-----------
Cette commande récupère la date et l'heure actuelles et les met en forme comme spécifié par la commande. Dans ce cas, le format inclut l'année complète (%Y), le mois numérique à deux chiffres (%m), la date (%d), le jour complet de la semaine (%A) et le décalage horaire par rapport à UTC (« Zoulou »).





Exemple 4

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

366

Description
-----------
Cette commande affiche le jour de l'année pour la date actuelle. Par exemple, le 31 décembre est le 365e jour de 2006, mais c'est le 366e jour de 2000.





Exemple 5

C:\PS>$a = get-date

C:\PS> $a.IsDaylightSavingTime()

True

Description
-----------
Ces commandes vous indiquent si la date et l'heure actuelles sont ajustées pour tenir compte de l'heure d'été dans les paramètres régionaux actuels. 

La première commande crée une variable nommée « $a », puis assigne l'objet récupéré par Get-Date à la variable $a. Ensuite, elle utilise la méthode IsDaylightSavingTime sur l'objet dans $a.

Pour afficher les propriétés et méthodes de l'objet DateTime, tapez :
 "get-date | get-member".





Exemple 6

C:\PS>$a = get-date

C:\PS> $a.ToUniversalTime()

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

Description
-----------
Ces commandes convertissent la date et l'heure actuelles en heure UTC.

La première commande crée une variable nommée « $a », puis assigne l'objet récupéré par Get-Date à la variable $a. Ensuite, elle utilise la méthode ToUniversalTime sur l'objet dans $a.





Exemple 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

Description
-----------
Windows Management Instrumentation (WMI) utilise un objet Date-Time différent de l'objet Date-Time .NET Framework retourné par Get-Date. Pour utiliser des informations date-heure (Date-Time) de WMI dans une commande avec les informations de date-heure de Get-Date, vous devez utiliser la méthode ConvertToDateTime pour convertir les objets CIM_DATETIME WMI en objets DateTime .NET Framework.

Les commandes de cet exemple affichent le nom et l'âge du BIOS sur un ordinateur distant, Server01. 

La première commande utilise l'applet de commande Get-WmiObject pour obtenir une instance de la classe Win32_BIOS sur Server01, puis la stocke dans la variable $a.

La deuxième commande utilise l'opérateur de pipeline (|) pour envoyer l'objet WMI stocké dans $a vers l'applet de commande Format-List. Le paramètre Property de Format-List est utilisé pour spécifier deux propriétés à afficher dans la liste, « Name » et « BIOS Age ». La propriété « BIOS Age » est spécifiée dans une table de hachage. La table inclut la clé Label, qui spécifie le nom de la propriété et la clé Expression, qui contient l'expression qui calcule l'âge BIOS. L'expression utilise la méthode ConvertToDateTime pour convertir chaque instance de ReleaseDate en un objet DateTime .NET Framework. Puis, la valeur est soustraite de la valeur de l'applet de commande Get-Date qui, sans paramètres, obtient la date actuelle.

Le caractère de backtick (`) est le caractère de continuation de ligne dans Windows PowerShell.





Exemple 8

C:\PS>get-date

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

Description
-----------
Cette commande obtient un objet DateTime et affiche la date et l'heure actuelles au format long des paramètres régionaux système, comme si vous aviez tapé « get-date -format F ».





Exemple 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

Description
-----------
Ces commandes montrent comment utiliser Get-Date avec Add-Content et d'autres applets de commande qui convertissent l'objet DateTime que Get-Date génère en une chaîne.

La première commande montre que l'affichage par défaut d'une commande « get-date » est au format de date et d'heure long.

La deuxième commande montre que l'affichage par défaut de la méthode ToString() de l'objet DateTime est au format de date et d'heure court.

La troisième commande utilise un opérateur de pipeline pour envoyer l'objet DateTime à l'applet de commande Add-Content, qui ajoute le contenu au fichier Test.txt. Étant donné que Add-Content utilise la méthode ToString() de l'objet DateTime, la date et l'heure ajoutées sont au format court.

La quatrième commande utilise le paramètre Format de Get-Date pour spécifier le format. Lorsque vous utilisez les paramètres Format ou UFormat, Get-Date génère une chaîne, et non pas un objet DateTime. Ensuite, lorsque vous envoyez la chaîne à Add-Content, elle ajoute cette chaîne au fichier Test.txt sans la modifier.





Voir aussi

Concepts

Set-Date
New-TimeSpan