New-TimeSpan
Создает объект TimeSpan.
Синтаксис
Date (По умолчанию)
New-TimeSpan
[[-Start] <DateTime>]
[[-End] <DateTime>]
[<CommonParameters>]
Time
New-TimeSpan
[-Days <Int32>]
[-Hours <Int32>]
[-Minutes <Int32>]
[-Seconds <Int32>]
[-Milliseconds <Int32>]
[<CommonParameters>]
Описание
Командлет New-TimeSpan создает объект TimeSpan, представляющий интервал времени.
Для сложения или вычитания времени из объектов DateTime можно использовать объект TimeSpan.
Без параметров команда New-TimeSpan возвращает объект TimeSpan, представляющий временной интервал длиной в ноль.
Примеры
Пример 1. Создание объекта TimeSpan для указанной длительности
Эта команда создает объект 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
Пример 2. Создание объекта TimeSpan для интервала времени
В этом примере создается новый объект TimeSpan, представляющий интервал между временем выполнения команды и 1 января 2010 г.
Эта команда не требует параметра start, так как значение по умолчанию параметра Start — текущая дата и время.
New-TimeSpan -End (Get-Date -Year 2010 -Month 1 -Day 1)
Пример 3. Получение даты через 90 дней от текущей даты
$90days = New-TimeSpan -Days 90
(Get-Date) + $90days
Эти команды возвращают дату, которая составляет 90 дней после текущей даты.
Пример 4. Обнаружение интервала timeSpan с момента обновления файла
Эта команда сообщает, сколько времени оно было с момента последнего обновления файла справки about_Remote. Этот формат команды можно использовать в любом файле или любом другом объекте, который имеет свойство LastWriteTime.
Эта команда работает, так как параметр запуска , New-TimeSpan имеет псевдоним LastWriteTime. При передаче объекта с помощью свойства LastWriteTime в New-TimeSpanPowerShell использует значение свойства LastWriteTime как значение параметра 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
Параметры
-Days
Указывает дни в интервале времени. Значение по умолчанию — 0.
Свойства параметров
| Тип: | Int32 |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
Time
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-End
Указывает конец интервала времени. Значение по умолчанию — текущая дата и время.
Свойства параметров
| Тип: | DateTime |
| Default value: | Current date and time |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
Date
| Position: | 1 |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | True |
| Значение из оставшихся аргументов: | False |
-Hours
Указывает часы в интервале времени. Значение по умолчанию — 0.
Свойства параметров
| Тип: | Int32 |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
Time
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-Milliseconds
Задает длину интервала времени в миллисекундах. Значение по умолчанию — 0.
Свойства параметров
| Тип: | Int32 |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
Time
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-Minutes
Указывает минуты в интервале времени. Значение по умолчанию — 0.
Свойства параметров
| Тип: | Int32 |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
Time
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-Seconds
Указывает длину интервала времени в секундах. Значение по умолчанию — 0.
Свойства параметров
| Тип: | Int32 |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
Time
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-Start
Указывает начало интервала времени. Введите строку, представляющую дату и время, например "3/15/09" или объект DateTime, например один из команды Get-Date. Значение по умолчанию — текущая дата и время.
Вы можете использовать Start или его псевдоним, LastWriteTime. Псевдоним LastWriteTime позволяет передавать объекты, имеющие свойство lastWriteTime, например файлы в файловой системе ([IO.FileInfo]), в параметр startNew-TimeSpan.
Свойства параметров
| Тип: | DateTime |
| Default value: | Current date and time |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
| Aliases: | ВремяПоследнейЗаписи |
Наборы параметров
Date
| Position: | 0 |
| Обязательно: | False |
| Значение из конвейера: | True |
| Значение из конвейера по имени свойства: | True |
| Значение из оставшихся аргументов: | False |
CommonParameters
Этот командлет поддерживает общие параметры: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction и -WarningVariable. Дополнительные сведения см. в разделе about_CommonParameters.
Входные данные
DateTime
Можно передать в конвейер объект DateTime, представляющий время начала, для этого командлета.
Выходные данные
TimeSpan
Этот командлет возвращает объект, представляющий интервал времени.
