Создает объект TimeSpan.

Синтаксис

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

New-TimeSpan [-Days <int>] [-Hours <int>] [-Minutes <int>] [-Seconds <int>] [<CommonParameters>]

Описание

Командлет New-TimeSpan создает объект TimeSpan, представляющий интервал времени. Объект TimeSpan позволяет прибавлять и вычитать время из объектов DateTime.

Без параметров команда New-Timespan возвращает объект TimeSpan, представляющий нулевой промежуток времени.

Параметры

-Days <int>

Указывает дни в промежутке времени. По умолчанию используется значение 0.

Обязательно?	false
Позиция?	named
Значение по умолчанию	0
Принимать входные данные из конвейера?	false
Принимать подстановочные знаки?	false

-End <DateTime>

Указывает конец промежутка времени. По умолчанию задаются текущие дата и время.

Обязательно?	false
Позиция?	2
Значение по умолчанию	Current date and time
Принимать входные данные из конвейера?	true (ByPropertyName)
Принимать подстановочные знаки?	false

-Hours <int>

Указывает часы в промежутке времени. Значение по умолчанию — 0.

Обязательно?	false
Позиция?	named
Значение по умолчанию	0
Принимать входные данные из конвейера?	false
Принимать подстановочные знаки?	false

-Minutes <int>

Указывает минуты в промежутке времени. По умолчанию используется значение 0.

Обязательно?	false
Позиция?	named
Значение по умолчанию	0
Принимать входные данные из конвейера?	false
Принимать подстановочные знаки?	false

-Seconds <int>

Указывает продолжительность промежутка времени в секундах. По умолчанию используется значение 0.

Обязательно?	false
Позиция?	named
Значение по умолчанию	0
Принимать входные данные из конвейера?	false
Принимать подстановочные знаки?	false

-Start <DateTime>

Указывает начало промежутка времени. Введите строку, представляющую дату и время, например "3/15/09", или объект DateTime, например объект, возвращаемый командой Get-Date.

По умолчанию задаются текущие дата и время.

Обязательно?	false
Позиция?	1
Значение по умолчанию	Current date and time
Принимать входные данные из конвейера?	true (ByValue, ByPropertyName)
Принимать подстановочные знаки?	false

<CommonParameters>

Данный командлет поддерживает общие параметры -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer и -OutVariable. Дополнительные сведения см. в разделе about_Commonparameters.

Ввод и вывод

Входным типом является тип объектов, которые можно передавать командлету по конвейеру. Возвращаемым типом является тип объектов, возвращаемых командлетом.

Входные данные

System.DateTime

Объект DateTime, представляющий время начала, можно передать командлету New-TimeSpan по конвейеру.

Выходные данные

System.Timespan

Командлет New-TimeSpan возвращает объект, представляющий промежуток времени.

Пример 1

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

Описание
-----------
Эта команда создает объект TimeSpan, определяющий промежуток длительностью 1 час 25 минут, и сохраняет его в переменной $timespan. Кроме того, она отображает представление объекта TimeSpan.

Пример 2

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

Описание
-----------
В этом примере создается новый объект TimeSpan, представляющий промежуток времени между временем выполнения команды и 1 января 2010 года.

В этой команде не требуется указывать параметр Start, поскольку значением параметра Start по умолчанию являются текущие дата и время.

Пример 3

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

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

Описание
-----------
Эти команды возвращают дату на 90 дней позже текущей даты.

New-TimeSpan