DateAndTime.TimeSerial(Int32, Int32, Int32) 메서드
정의
중요
일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.
날짜 정보가 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 -> DateTimePublic 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시간을 초과하면 필요에 따라 하루가 증가합니다. 다음 예제에서 및 Minute 값 Hour 은 결합된 시간이 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)
적용 대상
추가 정보
.NET