DateAndTime.TimeSerial(Int32, Int32, Int32) 메서드

정의

Date 날짜 정보가 연도 1의 1월 1을 기준으로 설정된 지정된 시간, 분 및 초를 나타내는 값을 반환합니다.

public:
 static DateTime TimeSerial(int Hour, int Minute, int Second);
public static DateTime TimeSerial(int Hour, int Minute, int Second);
static member TimeSerial : int * int * int -> DateTime
Public Function TimeSerial (Hour As Integer, Minute As Integer, Second As Integer) As DateTime

매개 변수

Hour
Int32

필수 사항입니다. 0에서 23까지의 정수 식입니다. 그러나 이 범위를 벗어난 값도 허용됩니다.

Minute
Int32

필수 사항입니다. 0에서 59까지의 정수 식입니다. 그러나 이 범위를 벗어난 값도 허용됩니다. 값이 계산된 시간에 추가되므로 음수 Minute 값은 해당 시간 이전의 분을 지정합니다.

Second
Int32

필수 사항입니다. 0에서 59까지의 정수 식입니다. 그러나 이 범위를 벗어난 값도 허용됩니다. 값이 계산된 분에 추가되므로 음수 Second 값은 해당 분 이전의 초를 지정합니다.

반품

Date 날짜 정보가 연도 1의 1월 1을 기준으로 설정된 지정된 시간, 분 및 초를 나타내는 값입니다.

예외

인수가 -2,147,483,648에서 2,147,483,647까지 범위를 벗어났습니다.

계산 시간은 음수 24시간보다 작습니다.

예제

다음 예제에서는 함수를 TimeSerial 사용하여 지정된 시간, 분 및 초의 시간을 반환합니다.

Dim thisTime As Date
thisTime = TimeSerial(16, 35, 17)

설명

다음 예제에서는 음수, 0 및 양수 인수 값을 보여 줍니다. 이 함수는 TimeSerial 정오 3시간 전 또는 오전 8시 45분 전의 15분을 나타내는 시간을 반환합니다.

Dim alarmTime As Date = TimeSerial(12 - 3, -15, 0)

Minute 표준 범위를 초과하거나 Second 초과하면 다음 큰 단위에 적절하게 적용됩니다. 예를 들어 75분을 지정하면 1시간 15분으로 평가됩니다.

TimeSerial 는 총 초 모듈로 86,400을 줄이며 이는 하루의 초 수입니다. 따라서 반환된 시간은 항상 00:00:00~23:59:59 사이입니다.

데이터 형식에는 Date 날짜 구성 요소가 포함됩니다. TimeSerial 는 이러한 모든 값을 1로 설정하므로 반환된 값은 1년 중 첫 번째 날을 나타냅니다. 그러나 인수 값으로 인해 계산된 시간이 24시간을 초과하는 경우 필요에 따라 하루가 증가합니다. 다음 예제에서 값은 Hour 24시간을 초과하는 결합된 시간을 생성합니다 Minute .

MsgBox(TimeSerial(23, 75, 0))
' The preceding statement displays "1/2/0001 12:15:00 AM".

인수 값으로 인해 음수 계산 시간이 발생하는 경우 날짜 정보는 0001/1/1로 설정되고 시간 정보는 00:00:00~23:59:59 사이로 조정됩니다. 그러나 계산 시간이 음수 24시간 ArgumentOutOfRangeException 보다 작으면 오류가 발생합니다.

모든 Date 값은 구조체에서 System.DateTime 지원되므로 해당 메서드는 값을 어셈블할 Date 때 추가 옵션을 제공합니다. 예를 들어 오버로드된 DateTime 생성자 중 하나를 사용하여 원하는 구성 요소 조합을 사용하여 변수를 채울 Date 수 있습니다. 다음 예제에서는 1978년 5월 6일 오전 8시 30분 이전의 10분의 1초로 설정합니다 newDateTime .

Dim newDateTime As Date = New Date(1978, 5, 6, 8, 29, 59, 900)

적용 대상

추가 정보