powershellscripts.com

Tutorials  PowerShell Cmdlet Help for New-TimeSpan



NAME
New-TimeSpan

SYNOPSIS
Creates a TimeSpan object.

SYNTAX
New-TimeSpan [[-Start] ] [[-End] ] []

New-TimeSpan [-Days ] [-Hours ] [-Minutes ] [-Seconds ] []


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


PARAMETERS
-Days
Indicates the days in the time span. The default is 0.

Required? false
Position? named
Default value 0
Accept pipeline input? false
Accept wildcard characters? false

-End
Indicates the end of a time span. The default is the current date and time.

Required? false
Position? 2
Default value Current date and time
Accept pipeline input? true (ByPropertyName)
Accept wildcard characters? false

-Hours
Indicates the hours in the time span. The default is zero.

Required? false
Position? named
Default value 0
Accept pipeline input? false
Accept wildcard characters? false

-Minutes
Indicates the minutes in the time span. The default is 0.

Required? false
Position? named
Default value 0
Accept pipeline input? false
Accept wildcard characters? false

-Seconds
Indicates the length of the time span in seconds. The default is 0.

Required? false
Position? named
Default value 0
Accept pipeline input? false
Accept wildcard characters? false

-Start
Indicates the start of a time span. Enter a string that represents the date and time, such as "3/15/09" or a Da
teTime object, such as one from a Get-Date command.

The default is the current date and time.

Required? false
Position? 1
Default value Current date and time
Accept pipeline input? true (ByValue, ByPropertyName)
Accept wildcard characters? false


This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer and OutVariable. For more information, type,
"get-help about_commonparameters".

INPUTS
System.DateTime
You can pipe a DateTime object that represents that start time to New-TimeSpan.


OUTPUTS
System.Timespan
New-TimeSpan returns an object that represents the time span.


NOTES





-------------------------- EXAMPLE 1 --------------------------

C:\PS>$timespan = new-timespan -hour 1 -minute 25


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





-------------------------- EXAMPLE 2 --------------------------

C:\PS>new-timespan -end (get-date -year 2010 -month 1 -day 1)


Description
-----------
This example creates a new TimeSpan object that represents the interval between the time that the command is run an
d January 1, 2010.

This command does not require the Start parameter, because the default value of the Start parameter is the current
date and time.





-------------------------- EXAMPLE 3 --------------------------

C:\PS>$90days = new-timespan -days 90

C:\PS> (get-date) + $90days


Description
-----------
These commands return the date that is 90 days after the current date.






RELATED LINKS
Online version: http://go.microsoft.com/fwlink/?LinkID=113360
Set-Date
Get-Date