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>]
   [-Milliseconds <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-TimeSpanLastWriteTime, 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 l'horodatage actuel.

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 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

-Milliseconds

Spécifie la durée de l’intervalle de temps en millisecondes. 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

-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 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
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 représentant l’heure de début vers cette applet de commande.

Sorties

TimeSpan

Cette applet de commande retourne un objet représentant l’intervalle de temps.