Создает объект 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 дней позже текущей даты.
См. также