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.






Voir aussi




Table des matières