La gestion des dates

(get-date).gettype() 

1. Vérifier l’aide

Nous allons vérifier comment fonctionne cette cmdlet.

Il s’agit d’une bonne pratique à utiliser lors de l’utilisation d’une nouvelle cmdlet afin d’en comprendre son fonctionnement.

Nous utiliserons pour cela la cmdlet Get-Help puis le nom de la cmdlet à analyser, ici Get-Date.

Get-Help Get-Date 

Ci-dessous le retour :

PS C:\Users\damien.vanrobaeys> Get-Help Get-Date 
NAME 
    Get-Date 
 
SYNOPSIS 
    Gets the current date and time. 
 
 
SYNTAX 
    Get-Date [[-Date] <System.DateTime>] [-Day <System.Int32>]  
[-DisplayHint {Date | Time | DateTime}] [-Format <System.String>] 
[-Hour <System.Int32>] [-Millisecond <System.Int32>] 
    [-Minute <System.Int32>] [-Month <System.Int32>] [-Second  
<System.Int32>] [-Year <System.Int32>] [<CommonParameters>] 
 
    Get-Date [[-Date] <System.DateTime>] [-Day <System.Int32>]  
[-DisplayHint {Date | Time | DateTime}] [-Hour <System.Int32>]  
[-Millisecond <System.Int32>] [-Minute <System.Int32>] 
    [-Month <System.Int32>] [-Second <System.Int32>] [-UFormat  
<System.String>] [-Year <System.Int32>] [<CommonParameters>] 
 
 
DESCRIPTION 
    The `Get-Date` cmdlet gets a DateTime object that represents 
the current date or a date that you specify. `Get-Date` can format 
the date and time in several .NET and UNIX formats. You 
    can use `Get-Date` to generate a date or time character string, 
and then send the string to other cmdlets or programs. 
 
    `Get-Date` uses the computer's culture settings to determine 
how the output is formatted. To view your computer's settings, ...

Get-Date -Format "Formatage souhaité" 

1. Formatage simple

Vous trouverez ci-dessous une liste des formats standards disponibles avec un exemple parlant.

2. Formatage personnalisé

Vous trouverez ci-dessous une liste des formats personnalisés disponibles avec un exemple parlant.

1. Convertir une chaîne de caractères en date

Prenons la chaîne de caractères suivante : 27/09/2022.

Ce texte aura donc comme type String.

Nous pouvons, par exemple, imaginer une date saisie par un utilisateur. Cette date au format string n’est donc pas facilement exploitable, il faudra alors la convertir au format DateTime.

Nous utiliserons pour cela la classe DateTime et la méthode ParseExact.

[Datetime]::ParseExact(Date, Format, $null) 

Dans notre exemple, la date est 27/09/2022, le format est donc dd/MM/yyyy.

Ci-dessous la conversion de la date à l’aide de la classe DateTime :

[Datetime]::ParseExact('27/09/2022', 'yy/MM/yyyy', $null) 

Ci-dessous le résultat :

Si la date est 09/27/2022, le format sera dd/MM/yyyy et le code :

[Datetime]::ParseExact('09/27/2022', 'yy/MM/yyyy', $null) 

Cela peut également s’écrire :

[System.Datetime]::ParseExact('09/27/2022', 'MM/dd/yyyy', $null) 

Ci-dessous le résultat :

Nous pouvons également utiliser la classe DateTime sans la méthode ParseExact, comme ci-dessous :

[DateTime]"Date" 

ou :

$Date="Date" 
[DateTime]$Date 

Ci-dessous avec notre date du 27 septembre 2022 :

[DateTime]"9/27/2022" 

Ci-dessous le résultat :

2. Convertir une date en chaîne de caractères

Nous allons...

1. Calcul d’intervalle entre deux dates

Convertissons ces deux dates en DateTime avec la méthode ParseExact.

$Date_A = [Datetime]::ParseExact('27/09/2022', 'dd/MM/yyyy', $null) 
$Date_B = [Datetime]::ParseExact('09/03/2020', 'dd/MM/yyyy', $null) 

Nous souhaitons maintenant comparer les deux dates en affichant le nombre de jours, heures, etc. d’intervalle. Pour cela, rien de plus simple, une soustraction :

$Date_A - $Date_B 

Ci-dessous le résultat retourné :

PS C:\Users\damien.vanrobaeys> $Date_A - $Date_B 
Days: 932 
Hours: 0 
Minutes: 0 
Seconds: 0 
Milliseconds: 0 
Ticks: 805248000000000 
TotalDays: 932 
TotalHours: 22368 
TotalMinutes: 1342080 
TotalSeconds: 80524800 
TotalMilliseconds : 80524800000 

Le résultat nous donne donc :

Pour récupérer le nombre de jours seulement, il suffira d’ajouter le calcul dans une variable puis de récupérer la propriété Days.

$Diff = $Date_A - $Date_B 
$Diff.days 

Ci-dessous le retour :

Cela peut nous être utile dans de nombreux cas et scripts :