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

정의

날짜 정보가 1년 1월 1일로 설정된 상태에서 지정된 시, 분, 초를 나타내는 Date 값을 반환합니다.Returns a Date value representing a specified hour, minute, and second, with the date information set relative to January 1 of the year 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

필수 요소.Required. 0에서 23까지의 정수 식입니다.Integer expression from 0 through 23. 그러나 이 범위를 벗어나는 값도 사용할 수 있습니다.However, values outside this range are also accepted.

Minute
Int32

필수 요소.Required. 0에서 59까지의 정수 식입니다.Integer expression from 0 through 59. 그러나 이 범위를 벗어나는 값도 사용할 수 있습니다.However, values outside this range are also accepted. Minute의 값은 계산된 시간에 더해지므로 음수 값은 계산된 시간에서 이 값만큼 뺀 분을 지정합니다.The value of Minute is added to the calculated hour, so a negative value specifies minutes before that hour.

Second
Int32

필수 요소.Required. 0에서 59까지의 정수 식입니다.Integer expression from 0 through 59. 그러나 이 범위를 벗어나는 값도 사용할 수 있습니다.However, values outside this range are also accepted. Second의 값은 계산된 분에 더해지므로 음수 값은 계산된 분에서 이 값만큼 뺀 초를 지정합니다.The value of Second is added to the calculated minute, so a negative value specifies seconds before that minute.

반환

DateTime

날짜 정보가 1년 1월 1일로 설정된 상태에서 지정된 시, 분, 초를 나타내는 Date 값입니다.A Date value representing a specified hour, minute, and second, with the date information set relative to January 1 of the year 1.

예외

인수의 범위가 -2,147,483,648 ~ 2,147,483,647을 벗어났습니다.An argument is outside the range -2,147,483,648 through 2,147,483,647

계산된 시간이 -24 시보다 작습니다.Calculated time is less than negative 24 hours.

예제

다음 예에서는 함수를 사용 하 여 TimeSerial 지정 된 시간, 분 및 초에 대 한 시간을 반환 합니다.The following example uses the TimeSerial function to return a time for the specified hour, minute, and second.

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

설명

다음 예제에서는 음수, 0 및 긍정 인수 값을 보여 줍니다.The following example demonstrates negative, zero, and positive argument values. TimeSerial함수는 정오 전 3 시간 이전에 15 분을 나타내는 시간 또는 오전 8:45:00을 반환 합니다.The TimeSerial function returns a time representing 15 minutes before three hours before noon, or 8:45:00 AM.

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

Minute또는가 정상 범위를 초과 하는 경우 적절 하 게 Second 다음 큰 단위에 적용 됩니다.If either Minute or Second exceeds its normal range, it is applied to the next larger unit as appropriate. 예를 들어, 75 분을 지정 하는 경우 1 시간 15 분으로 평가 됩니다.For example, if you specify 75 minutes, it is evaluated as one hour and 15 minutes.

TimeSerial 하루 중 초 수 인 총 초 모듈로 86400을 줄입니다.TimeSerial reduces the total seconds modulo 86,400, which is the number of seconds in a day. 따라서 반환 된 시간은 항상 00:00:00에서 23:59:59 사이입니다.Therefore, the returned time is always between 00:00:00 and 23:59:59.

Date데이터 형식에는 날짜 구성 요소가 포함 됩니다.The Date data type includes date components. TimeSerial 이 모든 값을 1로 설정 하므로 반환 된 값은 1 년의 첫째 날을 나타냅니다.TimeSerial sets all of these to 1, so the returned value represents the first day of the year 1. 그러나 인수 값으로 인해 계산 된 시간이 24 시간을 초과 하는 경우에는 필요에 따라 날짜가 증가 합니다.However, if the values of the arguments cause the calculated time to exceed 24 hours, the day is incremented as necessary. 다음 예제에서 및의 값은 Hour Minute 24 시간 이상 경과 된 시간을 반환 합니다.In the following example, the values of Hour and Minute result in a combined time of more than 24 hours.

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 사이로 조정 됩니다.If the values of the arguments result in a negative calculated time, the date information is set to 1/1/0001 and the time information is adjusted to be between 00:00:00 and 23:59:59. 그러나 계산 된 시간이 음수 24 시간 보다 작은 경우 ArgumentOutOfRangeException 오류가 발생 합니다.However, if the calculated time is less than negative 24 hours, an ArgumentOutOfRangeException error occurs.

모든 Date 값은 구조체에서 지원 되기 때문에 System.DateTime 해당 메서드는 값을 어셈블할 때 추가 옵션을 제공 Date 합니다.Since every Date value is supported by a System.DateTime structure, its methods give you additional options in assembling a Date value. 예를 들어 오버 로드 된 생성자 중 하나 DateTime 를 사용 하 여 Date 원하는 구성 요소 조합을 사용 하 여 변수를 채울 수 있습니다.For example, you can employ one of the overloaded DateTime constructors to populate a Date variable using the desired combination of components. 다음 예제는 newDateTime 오전 6 시에 1978 년 8:30 1 월 1 일 오전 1 시로를 설정 합니다.The following example sets newDateTime to May 6, 1978 at one tenth of a second before 8:30 in the morning:

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

적용 대상

추가 정보