다음을 통해 공유

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>]

Description

이 cmdlet은 New-TimeSpan 시간 간격을 나타내는 TimeSpan 개체를 만듭니다. TimeSpan 개체를 사용하여 DateTime 개체에서 시간을 추가하거나 뺄 수 있습니다.

매개 변수가 New-TimeSpan 없으면 명령은 0의 시간 간격을 나타내는 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 개체 만들기

다음은 명령이 실행되는 시간과 2010년 1월 1일 사이의 간격을 나타내는 새 TimeSpan 개체를 만드는 예제입니다.

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 속성의 값을 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 별칭을 사용하면 파일 시스템의 [System.Io.FileIO]파일과 같이 LastWriteTime 속성이 있는 개체를 시작 매개 변수로 New-TimeSpan파이프할 수 있습니다.

형식:DateTime
별칭:LastWriteTime
Position:0
Default value:Current date and time
필수:False
파이프라인 입력 허용:True
와일드카드 문자 허용:False

입력

DateTime

시작 시간을 나타내는 DateTime 개체를 이 cmdlet으로 파이프할 수 있습니다.

출력

TimeSpan

이 cmdlet은 시간 범위를 나타내는 개체를 반환합니다.