다음을 통해 공유

New-TimeSpan

모듈:
Microsoft.PowerShell.Utility Module

TimeSpan 개체를 만듭니다.

구문

Date (기본값) 

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

Time 

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

Description

New-TimeSpan cmdlet은 시간 간격을 나타내는 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 속성이 있는 다른 개체에서 이 명령 형식을 사용할 수 있습니다.

이 명령은 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
Default value:None
와일드카드 지원:False
DontShow:False

매개 변수 집합

Time
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-End

시간 범위의 끝을 지정합니다. 기본값은 현재 날짜 및 시간입니다.

매개 변수 속성

형식:DateTime
Default value:Current date and time
와일드카드 지원:False
DontShow:False

매개 변수 집합

Date
Position:1
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:True
나머지 인수의 값:False

-Hours

시간 범위의 시간을 지정합니다. 기본값은 0입니다.

매개 변수 속성

형식:Int32
Default value:None
와일드카드 지원:False
DontShow:False

매개 변수 집합

Time
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-Minutes

시간 범위의 분을 지정합니다. 기본값은 0입니다.

매개 변수 속성

형식:Int32
Default value:None
와일드카드 지원:False
DontShow:False

매개 변수 집합

Time
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-Seconds

시간 범위의 길이(초)를 지정합니다. 기본값은 0입니다.

매개 변수 속성

형식:Int32
Default value:None
와일드카드 지원:False
DontShow:False

매개 변수 집합

Time
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-Start

시간 범위의 시작을 지정합니다. 날짜 및 시간을 나타내는 문자열(예: "3/15/09") 또는 DateTime 개체(예: Get-Date 명령의 문자열)를 입력합니다. 기본값은 현재 날짜 및 시간입니다.

LastWriteTime시작 또는 해당 별칭을 사용할 수 있습니다. LastWriteTime 별칭을 사용하면 파일 시스템 파일과 같이 [System.Io.FileIO] 속성이 있는 개체를 New-TimeSpan 매개 변수로 파이프할 수 있습니다.

매개 변수 속성

형식:DateTime
Default value:Current date and time
와일드카드 지원:False
DontShow:False
별칭:마지막 쓰기 시간

매개 변수 집합

Date
Position:0
필수:False
파이프라인의 값:True
속성 이름별 파이프라인의 값:True
나머지 인수의 값:False

CommonParameters

이 cmdlet은 일반적인 매개 변수인 -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction 및 -WarningVariable 매개 변수를 지원합니다. 자세한 내용은 about_CommonParameters를 참조하세요.

입력

DateTime

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

출력

TimeSpan

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