Partager via

New-TimeSpan

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

Crée un objet TimeSpan.

Syntax

New-TimeSpan
   [[-Start] <DateTime>]
   [[-End] <DateTime>]
   [<CommonParameters>]
New-TimeSpan
   [-Days <Int32>]
   [-Hours <Int32>]
   [-Minutes <Int32>]
   [-Seconds <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 : Create un objet TimeSpan pour une durée spécifiée

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. 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 : Create 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 depuis combien de temps le fichier d’aide about_remote a été mis à jour. 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 LastWriteTime. Lorsque vous dirigez un objet qui a une propriété LastWriteTime vers New-TimeSpan, 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 de l’intervalle de temps. La valeur par défaut est 0.

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-End

Spécifie la fin d’un intervalle de temps. La valeur par défaut est l'horodatage actuel.

Type:DateTime
Position:1
Default value:Current date and time
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Hours

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

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Minutes

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

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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 « 15/03/09 » ou un objet DateTime , tel qu’un objet 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 , tels que les fichiers du système de fichiers [System.Io.FileIO], vers le paramètre Start de New-TimeSpan.

Type:DateTime
Aliases:LastWriteTime
Position:0
Default value:Current date and time
Required:False
Accept pipeline input:True
Accept wildcard characters:False

Entrées

DateTime

Vous pouvez diriger un objet DateTime qui représente cette heure de début vers New-TimeSpan.

Sorties

TimeSpan

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