다음을 통해 공유


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

정의

날짜 정보가 1년 1월 1일로 설정된 상태에서 지정된 시, 분, 초를 나타내는 Date 값을 반환합니다.

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의 값은 계산된 분에 더해지므로 음수 값은 계산된 분에서 이 값만큼 뺀 초를 지정합니다.

반환

날짜 정보가 1년 1월 1일로 설정된 상태에서 지정된 시, 분, 초를 나타내는 Date 값입니다.

예외

인수의 범위가 -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시간을 초과하면 필요에 따라 하루가 증가합니다. 다음 예제에서 및 MinuteHour 은 결합된 시간이 24시간을 초과합니다.

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

인수 값으로 인해 계산 시간이 음수이면 날짜 정보가 1/1/0001로 설정되고 시간 정보가 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)  

적용 대상

추가 정보