New-TimeSpan
Crée un objet TimeSpan.
Syntaxe
New-TimeSpan [[-Start] <DateTime>] [[-End] <DateTime>] [<CommonParameters>]
New-TimeSpan [-Days <int>] [-Hours <int>] [-Minutes <int>] [-Seconds <int>] [<CommonParameters>]
Description
L'applet de commande New-TimeSpan crée un objet TimeSpan qui représente un intervalle de temps. Vous pouvez utiliser un objet TimeSpan pour ajouter ou soustraire du temps aux objets DateTime.
Sans paramètres, une commande « New-Timespan » retourne un objet timespan qui représente un intervalle de temps de zéro.
Paramètres
-Days <int>
Indique les jours dans la durée. La valeur par défaut est 0.
Obligatoire ? |
false |
Position ? |
named |
Valeur par défaut |
0 |
Accepter l'entrée de pipeline ? |
false |
Accepter les caractères génériques ? |
false |
-End <DateTime>
Indique la fin d'une durée. La valeur par défaut correspond à la date et à l'heure actuelles.
Obligatoire ? |
false |
Position ? |
2 |
Valeur par défaut |
Current date and time |
Accepter l'entrée de pipeline ? |
true (ByPropertyName) |
Accepter les caractères génériques ? |
false |
-Hours <int>
Indique les heures dans la durée. La valeur par défaut est zéro.
Obligatoire ? |
false |
Position ? |
named |
Valeur par défaut |
0 |
Accepter l'entrée de pipeline ? |
false |
Accepter les caractères génériques ? |
false |
-Minutes <int>
Indique les minutes dans la durée. La valeur par défaut est 0.
Obligatoire ? |
false |
Position ? |
named |
Valeur par défaut |
0 |
Accepter l'entrée de pipeline ? |
false |
Accepter les caractères génériques ? |
false |
-Seconds <int>
Indique la longueur de la durée en secondes. La valeur par défaut est 0.
Obligatoire ? |
false |
Position ? |
named |
Valeur par défaut |
0 |
Accepter l'entrée de pipeline ? |
false |
Accepter les caractères génériques ? |
false |
-Start <DateTime>
Indique le démarrage d'une durée. Entrez une chaîne qui représente la date et l'heure, telle que « 3/15/09 », ou un objet DateTime, tel que ceux obtenus à partir d'une commande Get-Date.
La valeur par défaut correspond à la date et à l'heure actuelles.
Obligatoire ? |
false |
Position ? |
1 |
Valeur par défaut |
Current date and time |
Accepter l'entrée de pipeline ? |
true (ByValue, ByPropertyName) |
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 |
System.DateTime Vous pouvez diriger un objet DateTime qui représente cette heure de début vers New-TimeSpan. |
Sorties |
System.Timespan New-TimeSpan retourne un objet qui représente la durée. |
Exemple 1
C:\PS>$timespan = new-timespan -hour 1 -minute 25
Description
-----------
Cette commande crée un objet TimeSpan d'une durée de 1 heure et 25 minutes et le stocke dans une variable nommée $timespan. Elle affiche une représentation de l'objet TimeSpan.
Exemple 2
C:\PS>new-timespan -end (get-date -year 2010 -month 1 -day 1)
Description
-----------
Cet exemple crée un nouvel objet TimeSpan qui représente l'intervalle entre l'heure où la commande est exécutée et le 1er janvier 2010.
Cette commande ne requiert aucun paramètre Start, étant donné que la valeur par défaut du paramètre Start correspond à la date et à l'heure actuelles.
Exemple 3
C:\PS>$90days = new-timespan -days 90
C:\PS> (get-date) + $90days
Description
-----------
Ces commandes retournent la date correspondant à 90 jours après la date actuelle.