Поиск по сайту:

New-TimeSpan (Microsoft.PowerShell.Utility)

New-TimeSpan

Модуль:
Microsoft.PowerShell.Utility

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

Синтаксис

New-TimeSpan
   [[-Start] <DateTime>]
   [[-End] <DateTime>]
   [<CommonParameters>]
New-TimeSpan
   [-Days <Int32>]
   [-Hours <Int32>]
   [-Minutes <Int32>]
   [-Seconds <Int32>]
   [-Milliseconds <Int32>]
   [<CommonParameters>]

Описание

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

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

Примеры

Пример 1. Создайте объект TimeSpan на указанный период времени.

Эта команда создает объект TimeSpan длительностью 1 час 25 минут и сохраняет его в переменной с именем $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.

Эта команда работает, поскольку параметр Start New-TimeSpan имеет псевдоним LastWriteTime. Когда вы передаете объект, имеющий свойство LastWriteTime, в New-TimeSpan, PowerShell использует значение свойства LastWriteTime в качестве значения < параметрstrong>Начало.

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

Позиция:

Именованный

Значение по умолчанию:

None

Необходимый:

False

Примите ввод конвейера:

False

Принимайте подстановочные знаки:

False

-End

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

Тип :

DateTime

Позиция:

1

Значение по умолчанию:

Текущая дата и время

Необходимый:

False

Примите ввод конвейера:

True

Принимайте подстановочные знаки:

False

-Hours

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

Тип :

Int32

Позиция:

Именованный

Значение по умолчанию:

None

Необходимый:

False

Примите ввод конвейера:

False

Принимайте подстановочные знаки:

False

-Milliseconds

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

Тип :

Int32

Позиция:

Именованный

Значение по умолчанию:

None

Необходимый:

False

Примите ввод конвейера:

False

Принимайте подстановочные знаки:

False

-Minutes

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

Тип :

Int32

Позиция:

Именованный

Значение по умолчанию:

None

Необходимый:

False

Примите ввод конвейера:

False

Принимайте подстановочные знаки:

False

-Seconds

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

Тип :

Int32

Позиция:

Именованный

Значение по умолчанию:

None

Необходимый:

False

Примите ввод конвейера:

False

Принимайте подстановочные знаки:

False

-Start

Указывает начало интервала времени. Введите строку, представляющую дату и время, например «15 марта 2009 г.», или объект DateTime, например объект из команды Get-Date. Значением по умолчанию является текущая дата и время.

Вы можете использовать Start или его псевдоним LastWriteTime. Псевдоним LastWriteTime позволяет передавать по конвейеру объекты, имеющие свойство LastWriteTime, например файлы в файловой системе [System.Io.FileIO], в параметр Start New-TimeSpan.

Тип :

DateTime

Псевдонимы:

LastWriteTime

Позиция:

0

Значение по умолчанию:

Текущая дата и время

Необходимый:

False

Примите ввод конвейера:

True

Принимайте подстановочные знаки:

False

Входы

ДатаВремя

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

Выходы

Временной интервал

Этот командлет возвращает объект, представляющий интервал времени.