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


New-TimeSpan

Создает объект 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 .

Эта команда работает, так как параметр New-TimeSpan Start имеет псевдоним LastWriteTime. При канале объекта с свойством New-TimeSpanLastWriteTime в PowerShell в качестве значения параметра Start используется значение свойства LastWriteTime.

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, например файлы в файловой системе[System.Io.FileIO], в параметр New-TimeSpanStart .

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

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

DateTime

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

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

TimeSpan

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