New-TimeSpan
Crée un objet TimeSpan.
Syntax
New-TimeSpan
[[-Start] <DateTime>]
[[-End] <DateTime>]
[<CommonParameters>]
New-TimeSpan
[-Days <Int32>]
[-Hours <Int32>]
[-Minutes <Int32>]
[-Seconds <Int32>]
[<CommonParameters>]
Description
L’applet New-TimeSpan
de commande crée un objet TimeSpan qui représente un intervalle de temps.
Vous pouvez utiliser un objet TimeSpan pour ajouter ou soustraire l’heure des objets DateTime .
Sans paramètres, une New-TimeSpan
commande retourne un objet TimeSpan qui représente un intervalle de temps de zéro.
Exemples
Exemple 1 : Créer un objet TimeSpan pour une durée spécifiée
Cette commande crée un objet TimeSpan avec une durée de 1 heure et 25 minutes et le stocke dans une variable nommée $TimeSpan
. Il affiche une représentation de l’objet TimeSpan .
$TimeSpan = New-TimeSpan -Hours 1 -Minutes 25
$TimeSpan
Days : 0
Hours : 1
Minutes : 25
Seconds : 0
Milliseconds : 0
Ticks : 51000000000
TotalDays : 0.0590277777777778
TotalHours : 1.41666666666667
TotalMinutes : 85
TotalSeconds : 5100
TotalMilliseconds : 5100000
Exemple 2 : Créer un objet TimeSpan pour un intervalle de temps
Cet exemple crée un objet TimeSpan qui représente l’intervalle entre l’exécution de la commande et le 1er janvier 2010.
Cette commande ne nécessite pas le paramètre Start , car la valeur par défaut du paramètre Start est la date et l’heure actuelles.
New-TimeSpan -End (Get-Date -Year 2010 -Month 1 -Day 1)
Exemple 3 : Obtenir la date 90 jours à partir de la date actuelle
$90days = New-TimeSpan -Days 90
(Get-Date) + $90days
Ces commandes retournent la date située 90 jours après la date actuelle.
Exemple 4 : Découvrir le timeSpan depuis la mise à jour d’un fichier
Cette commande vous indique combien de temps il a été depuis la dernière mise à jour du fichier d’aide about_remote . Vous pouvez utiliser ce format de commande sur n’importe quel fichier ou tout autre objet qui a une propriété LastWriteTime .
Cette commande fonctionne, car le paramètre Start d’a New-TimeSpan
un alias de LastWriteTime. Lorsque vous dirigez un objet avec une propriété New-TimeSpan
LastWriteTime, PowerShell utilise la valeur de la propriété LastWriteTime comme valeur du paramètre Start.
Get-ChildItem $PSHOME\en-us\about_remote.help.txt | New-TimeSpan
Days : 321
Hours : 21
Minutes : 59
Seconds : 22
Milliseconds : 312
Ticks : 278135623127728
TotalDays : 321.916230471907
TotalHours : 7725.98953132578
TotalMinutes : 463559.371879547
TotalSeconds : 27813562.3127728
TotalMilliseconds : 27813562312.7728
Paramètres
-Days
Spécifie les jours dans l’intervalle de temps. La valeur par défaut est 0.
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-End
Spécifie la fin d’un intervalle de temps. La valeur par défaut est l'horodatage actuel.
Type: | DateTime |
Position: | 1 |
Default value: | Current date and time |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Hours
Spécifie les heures dans l’intervalle de temps. La valeur par défaut est zéro.
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Minutes
Spécifie les minutes dans l’intervalle de temps. La valeur par défaut est 0.
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Seconds
Spécifie la durée de l’intervalle de temps en secondes. La valeur par défaut est 0.
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Start
Spécifie le début d’un intervalle de temps.
Entrez une chaîne qui représente la date et l’heure, par exemple « 3/15/09 » ou un objet DateTime , tel qu’un objet à partir d’une Get-Date
commande. La valeur par défaut est l'horodatage actuel.
Vous pouvez utiliser Start ou son alias, LastWriteTime.
L’alias LastWriteTime vous permet de diriger les objets qui ont une propriété LastWriteTime , comme les fichiers du système [System.Io.FileIO]
de fichiers, vers le paramètre Start de New-TimeSpan
.
Type: | DateTime |
Aliases: | LastWriteTime |
Position: | 0 |
Default value: | Current date and time |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
Entrées
Vous pouvez diriger un objet DateTime représentant l’heure de début vers cette applet de commande.
Sorties
Cette applet de commande retourne un objet représentant l’intervalle de temps.
Liens associés
Commentaires
https://aka.ms/ContentUserFeedback.
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultezEnvoyer et afficher des commentaires pour