Поделиться через

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, представляющий интервал времени. Для сложения или вычитания времени из объектов DateTime можно использовать объект TimeSpan.

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

Примеры

Пример 1. Создание объекта TimeSpan для указанной длительности

Эта команда создает объект timeSpan TimeSpan с длительностью 1 часа и 25 минут и сохраняет его в переменной с именем . В нем отображается представление объекта 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
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-End

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

Тип:DateTime
Position:1
Default value:Current date and time
Обязательно:False
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-Hours

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

Тип:Int32
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-Milliseconds

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

Тип:Int32
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-Minutes

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

Тип:Int32
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-Seconds

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

Тип:Int32
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-Start

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

Вы можете использовать Start или его псевдоним, LastWriteTime. Псевдоним LastWriteTime позволяет передавать объекты, имеющие свойство lastWriteTime, например файлы в файловой системе ([IO.FileInfo]), в параметр startNew-TimeSpan.

Тип:DateTime
Aliases:LastWriteTime
Position:0
Default value:Current date and time
Обязательно:False
Принять входные данные конвейера:True
Принять подстановочные знаки:False

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

DateTime

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

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

TimeSpan

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