新时间跨度（Microsoft.PowerShell.Utility）

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 cmdlet 创建一个表示时间间隔的 TimeSpan 对象。您可以使用 TimeSpan 对象在 DateTime 对象中添加或减去时间。

如果没有参数，New-TimeSpan 命令将返回一个表示零时间间隔的 TimeSpan 对象。

示例

示例 1：创建指定持续时间的 TimeSpan 对象

此命令创建一个持续时间为 1 小时 25 分钟的 TimeSpan 对象，并将其存储在名为 $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 对象，该对象表示命令运行时间与 2010 年 1 月 1 日之间的时间间隔。

此命令不需要 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：发现文件更新后的时间跨度

此命令告诉您自上次更新 about_remote 帮助文件以来已经过去了多长时间。您可以在任何文件或具有 LastWriteTime 属性的任何其他对象上使用此命令格式。

此命令之所以有效，是因为 New-TimeSpan 的 Start 参数有一个别名 LastWriteTime。当您通过管道将具有 LastWriteTime 属性的对象传递给 New-TimeSpan 时，PowerShell 会使用 LastWriteTime 属性的值作为 New-TimeSpan 的值。强>启动参数。

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。

整数32

命名

None

False

False

False

-End

指定时间跨度的结束点。默认值为当前日期和时间。

DateTime

1

当前日期和时间

False

True

False

-Hours

指定时间跨度中的小时数。默认值为 0。

整数32

命名

None

False

False

False

-Milliseconds

指定时间跨度的长度（以毫秒为单位）。默认值为 0。

整数32

命名

None

False

False

False

-Minutes

指定时间跨度中的分钟。默认值为 0。

整数32

命名

None

False

False

False

-Seconds

指定时间跨度的长度（以秒为单位）。默认值为 0。

整数32

命名

None

False

False

False

-Start

指定时间跨度的开始。输入表示日期和时间的字符串，例如“3/15/09”或 DateTime 对象，例如来自 Get-Date 命令的对象。默认值为当前日期和时间。

您可以使用Start或其别名LastWriteTime。 LastWriteTime 别名允许您通过管道将具有 LastWriteTime 属性的对象（例如文件系统 [System.Io.FileIO] 中的文件）传输到New-TimeSpan 的 Start 参数。

DateTime

LastWriteTime

0

当前日期和时间

False

True

False

输入

日期时间

您可以通过管道将表示开始时间的 DateTime 对象传递给此 cmdlet。

输出

时间跨度

此 cmdlet 返回一个表示时间跨度的对象。