Share via

New-TimeSpan

  • Ссылка
Модуль:
Microsoft.PowerShell.Utility

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

Синтаксис

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

Описание

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

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

Примеры

Пример 1. Create объекта 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. Create объекта 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-TimeSpanStart имеет псевдоним LastWriteTime. Когда объект, имеющий свойство LastWriteTime , передается New-TimeSpanв , PowerShell использует значение свойства 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.

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-End

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

Type:DateTime
Position:1
Default value:Current date and time
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Hours

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

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Minutes

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

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Seconds

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

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Start

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

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

Type:DateTime
Aliases:LastWriteTime
Position:0
Default value:Current date and time
Required:False
Accept pipeline input:True
Accept wildcard characters:False

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

DateTime

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

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

TimeSpan

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