New-TimeSpan
Creates a TimeSpan object.
Sintassi
Date (impostazione predefinita).
New-TimeSpan
[[-Start] <DateTime>]
[[-End] <DateTime>]
[<CommonParameters>]
Time
New-TimeSpan
[-Days <Int32>]
[-Hours <Int32>]
[-Minutes <Int32>]
[-Seconds <Int32>]
[-Milliseconds <Int32>]
[<CommonParameters>]
Descrizione
The New-TimeSpan cmdlet creates a TimeSpan object that represents a time interval.
You can use a TimeSpan object to add or subtract time from DateTime objects.
Without parameters, a New-TimeSpan command returns a TimeSpan object that represents a time
interval of zero.
Esempio
Example 1: Create a TimeSpan object for a specified duration
This command creates a TimeSpan object with a duration of 1 hour and 25 minutes and stores it in
a variable named $TimeSpan. It displays a representation of the TimeSpan object.
$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
Example 2: Create a TimeSpan object for a time interval
This example creates a new TimeSpan object that represents the interval between the time that the command is run and January 1, 2010.
This command doesn't require the Start parameter, because the default value of the Start parameter is the current date and time.
New-TimeSpan -End (Get-Date -Year 2010 -Month 1 -Day 1)
Example 3: Get the date 90 days from the current date
$90days = New-TimeSpan -Days 90
(Get-Date) + $90days
These commands return the date that is 90 days after the current date.
Example 4: Discover the TimeSpan since a file was updated
This command tells you how long it has been since the about_Remote help file was last updated. You can use this command format on any file, or any other object that has a LastWriteTime property.
This command works because the Start parameter of New-TimeSpan has an alias of
LastWriteTime. When you pipe an object that has a LastWriteTime property to New-TimeSpan,
PowerShell uses the value of the LastWriteTime property as the value of the Start parameter.
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
Parametri
-Days
Specifies the days in the time span. The default value is 0.
Proprietà dei parametri
| Tipo: | Int32 |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
Time
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-End
Specifies the end of a time span. The default value is the current date and time.
Proprietà dei parametri
| Tipo: | DateTime |
| Valore predefinito: | Current date and time |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
Date
| Posizione: | 1 |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | True |
| Valore dagli argomenti rimanenti: | False |
-Hours
Specifies the hours in the time span. The default value is 0.
Proprietà dei parametri
| Tipo: | Int32 |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
Time
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-Milliseconds
Specifies the length of the time span in milliseconds. The default value is 0.
Proprietà dei parametri
| Tipo: | Int32 |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
Time
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-Minutes
Specifies the minutes in the time span. The default value is 0.
Proprietà dei parametri
| Tipo: | Int32 |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
Time
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-Seconds
Specifies the length of the time span in seconds. The default value is 0.
Proprietà dei parametri
| Tipo: | Int32 |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
Time
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-Start
Specifies the start of a time span. Enter a string that represents the date and time, such as
"3/15/09" or a DateTime object, such as one from a Get-Date command. The default value is the
current date and time.
You can use Start or its alias, LastWriteTime. The LastWriteTime alias lets you pipe
objects that have a LastWriteTime property, such as files in the file system ([IO.FileInfo]),
to the Start parameter of New-TimeSpan.
Proprietà dei parametri
| Tipo: | DateTime |
| Valore predefinito: | Current date and time |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
| Alias: | LastWriteTime |
Set di parametri
Date
| Posizione: | 0 |
| Obbligatorio: | False |
| Valore dalla pipeline: | True |
| Valore dalla pipeline in base al nome della proprietà: | True |
| Valore dagli argomenti rimanenti: | False |
CommonParameters
This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.
Input
DateTime
You can pipe a DateTime object representing the start time to this cmdlet.
Output
TimeSpan
This cmdlet returns an object representing the time span.
