Partager via

New-TimeSpan

  • Référence
Module:
Microsoft.PowerShell.Utility

Crée un objet TimeSpan.

Syntaxe

New-TimeSpan
   [[-Start] <DateTime>]
   [[-End] <DateTime>]
   [<CommonParameters>]
New-TimeSpan
   [-Days <Int32>]
   [-Hours <Int32>]
   [-Minutes <Int32>]
   [-Seconds <Int32>]
   [<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 des objets DateTime.

Sans paramètres, une commande New-TimeSpan 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 qui est de 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 de New-TimeSpan a un alias de LastWriteTime. Lorsque vous dirigez un objet qui a une propriété LastWriteTime vers , 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
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-End

Spécifie la fin d’un intervalle de temps. La valeur par défaut est la date et l’heure actuelles.

Type:DateTime
Position:1
Valeur par défaut:Current date and time
Obligatoire:False
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-Hours

Spécifie les heures dans l’intervalle de temps. La valeur par défaut est zéro.

Type:Int32
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Minutes

Spécifie les minutes dans l’intervalle de temps. La valeur par défaut est 0.

Type:Int32
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques: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
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques: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 commande Get-Date. La valeur par défaut est la date et l’heure actuelles.

Vous pouvez utiliser démarrer ou son alias, LastWriteTime. L’alias LastWriteTime vous permet de diriger des objets qui ont une propriété LastWriteTime, comme les fichiers du système de fichiers , vers le paramètre Start de de .

Type:DateTime
Alias:LastWriteTime
Position:0
Valeur par défaut:Current date and time
Obligatoire:False
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

Entrées

DateTime

Vous pouvez diriger un objet DateTime qui représente l’heure de début à New-TimeSpan.

Sorties

TimeSpan

New-TimeSpan retourne un objet qui représente l’intervalle de temps.