Partager via

New-TimeSpan

Module:
Microsoft.PowerShell.Utility Module

Crée un objet TimeSpan.

Syntaxe

Date (Par défaut) 

New-TimeSpan
    [[-Start] <DateTime>]
    [[-End] <DateTime>]
    [<CommonParameters>]

Time 

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.

Propriétés du paramètre

Type:Int32
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

Time
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-End

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

Propriétés du paramètre

Type:DateTime
Valeur par défaut:Current date and time
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

Date
Position:1
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants:False

-Hours

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

Propriétés du paramètre

Type:Int32
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

Time
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-Minutes

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

Propriétés du paramètre

Type:Int32
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

Time
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-Seconds

Spécifie la durée de l’intervalle de temps en secondes. La valeur par défaut est 0.

Propriétés du paramètre

Type:Int32
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

Time
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants: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 .

Propriétés du paramètre

Type:DateTime
Valeur par défaut:Current date and time
Prend en charge les caractères génériques:False
DontShow:False
Alias:LastWriteTime

Jeux de paramètres

Date
Position:0
Obligatoire:False
Valeur du pipeline:True
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants:False

CommonParameters

Cette applet de commande prend en charge les paramètres courants : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction et -WarningVariable. Pour plus d’informations, consultez about_CommonParameters.

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.