Utiliser des variables et méthodes de date dans des scripts Windows PowerShell
La plupart des scripts que vous créez doivent référencer la date actuelle ou un point antérieur dans le temps. Par exemple, par souci d’unicité, vous pourriez créer un nom de fichier journal basé sur la date actuelle. Vous pourriez également rechercher dans AD DS des utilisateurs qui ne se sont pas connectés pendant une période prolongée. Pour accomplir ces tâches, vous pouvez utiliser des variables DateHeure.
Propriétés de variable DateHeure
Une variable DateHeure contient à la fois la date et l’heure. Vous pouvez utiliser les propriétés de variable DateHeure pour accéder à des parties spécifiques de la date ou de l’heure. Le tableau suivant répertorie quelques-unes des propriétés disponibles pour une variable DateHeure.
Tableau 1 : propriétés disponibles pour une variable DateHeure
| Propriété | Descriptif |
|---|---|
| Heure | Retourne les heures de l’heure au format 24 heures. |
| Minute | Retourne les minutes de l’heure. |
| Deuxième | Retourne les secondes de l’heure. |
| TimeOfDay | Retourne des informations détaillées sur l’heure de la journée, incluant l’heure, les minutes et les secondes. |
| Date | Retourne uniquement la date, non l’heure. |
| DayOfWeek | Retourne le jour de la semaine, par exemple, lundi. |
| Mois | Retourne le mois sous la forme d’un nombre. |
| Année | Retourne l’année. |
Méthodes de variable DateHeure
Une variable DateHeure offre également de nombreuses méthodes disponibles pour manipuler l’heure. Les méthodes permettent d’ajouter ou de soustraire du temps. Il existe également des méthodes permettant de manipuler la sortie d’une variable DateHeure de manières spécifiques. Le tableau suivant répertorie certaines des méthodes de variable DateHeure.
Tableau 2 : Méthodes de variable DateHeure
| Méthode | Descriptif |
|---|---|
| AddDays(double valeur) | Ajoute le nombre spécifié de jours. |
| AddHours(double value) | Ajoute le nombre spécifié d’heures. |
| AddMinutes(double valeur) | Ajoute le nombre spécifié de minutes. |
| AddMonths(int months) | Ajoute le nombre spécifié de mois. |
| AddYears(int value) | Ajoute le nombre spécifié d’années. |
| ToLongDateString() | Retourne la date au format long sous forme de chaîne. |
| ToShortDateString() | Retourne la date au format abrégé sous forme de chaîne. |
| ToLongTimeString() | Retourne l’heure au format long sous forme de chaîne. |
| ToShortTimeString() | Retourne l’heure au format abrégé sous forme de chaîne. |
Remarque
Si vous devez soustraire du temps d’une variable DateHeure, utilisez l’une des méthodes d’ajout de temps en utilisant un nombre négatif comme paramètre. Voici un exemple : $date.AddDays(-60).