다음을 통해 공유


New-TimeSpan

TimeSpan 개체를 만듭니다.

구문

New-TimeSpan [[-Start] <DateTime>] [[-End] <DateTime>] [<CommonParameters>]

New-TimeSpan [-Days <int>] [-Hours <int>] [-Minutes <int>] [-Seconds <int>] [<CommonParameters>]

설명

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

매개 변수를 지정하지 않는 경우 "New-Timespan" 명령은 시간 간격 0을 나타내는 timespan 개체를 반환합니다.

매개 변수

-Days <int>

시간 범위에서 일 수를 나타냅니다. 기본값은 0입니다.

필수 여부

false

위치

named

기본값

0

파이프라인 입력 적용 여부

false

와일드카드 문자 적용 여부

false

-End <DateTime>

시간 범위의 끝을 나타냅니다. 기본값은 현재 날짜 및 시간입니다.

필수 여부

false

위치

2

기본값

현재 날짜 및 시간

파이프라인 입력 적용 여부

true (ByPropertyName)

와일드카드 문자 적용 여부

false

-Hours <int>

시간 범위에서 시간을 나타냅니다. 기본값은 0입니다.

필수 여부

false

위치

named

기본값

0

파이프라인 입력 적용 여부

false

와일드카드 문자 적용 여부

false

-Minutes <int>

시간 범위에서 분을 나타냅니다. 기본값은 0입니다.

필수 여부

false

위치

named

기본값

0

파이프라인 입력 적용 여부

false

와일드카드 문자 적용 여부

false

-Seconds <int>

시간 범위의 길이(초)를 나타냅니다. 기본값은 0입니다.

필수 여부

false

위치

named

기본값

0

파이프라인 입력 적용 여부

false

와일드카드 문자 적용 여부

false

-Start <DateTime>

시간 범위의 시작을 나타냅니다. "3/15/09"와 같이 날짜 및 시간을 나타내는 문자열 또는 Get-Date 명령의 DateTime 개체를 입력합니다.

기본값은 현재 날짜 및 시간입니다.

필수 여부

false

위치

1

기본값

현재 날짜 및 시간

파이프라인 입력 적용 여부

true (ByValue, ByPropertyName)

와일드카드 문자 적용 여부

false

<CommonParameters>

이 cmdlet은 -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer, -OutVariable 등의 일반 매개 변수를 지원합니다. 자세한 내용은 about_commonparameters.

입력 및 출력

입력 유형은 cmdlet으로 파이프할 수 있는 개체의 유형입니다. 반환 유형은 cmdlet에서 반환되는 개체의 유형입니다.

입력

System.DateTime

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

출력

System.Timespan

New-TimeSpan은 시간 범위를 나타내는 개체를 반환합니다.

예 1

C:\PS>$timespan = new-timespan -hour 1 -minute 25

설명
-----------
이 명령은 기간이 1시간 25분인 TimeSpan 개체를 만들고 이를 $timespan이라는 변수에 저장합니다. 이 명령은 TimeSpan 개체의 표시를 나타냅니다.





예 2

C:\PS>new-timespan -end (get-date -year 2010 -month 1 -day 1)

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

Start 매개 변수의 기본값이 현재 날짜 및 시간이므로 이 명령을 실행하는 경우 Start 매개 변수가 필요하지 않습니다.





예 3

C:\PS>$90days = new-timespan -days 90

C:\PS> (get-date) + $90days

설명
-----------
이들 명령은 현재 날짜에서 90일 이후의 날짜를 반환합니다.





참고 항목

개념

Set-Date
Get-Date