다음을 통해 공유


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

정의

Date 시간 정보가 자정(00:00:00)으로 설정된 지정된 연도, 월 및 일을 나타내는 값을 반환합니다.

public:
 static DateTime DateSerial(int Year, int Month, int Day);
public static DateTime DateSerial (int Year, int Month, int Day);
static member DateSerial : int * int * int -> DateTime
Public Function DateSerial (Year As Integer, Month As Integer, Day As Integer) As DateTime

매개 변수

Year
Int32

필수 요소. 1에서 9999까지의 정수 식입니다. 이 범위 아래의 값도 사용할 수 있습니다. 가 0에서 99인 경우 Year "주의" 섹션에 설명된 대로 1930년에서 2029년 사이인 것으로 해석됩니다. Year가 1보다 작은 경우에는 현재 연도에서 해당 값을 뺍니다.

Month
Int32

필수 요소. 1에서 12까지의 정수 식입니다. 그러나 이 범위를 벗어나는 값도 사용할 수 있습니다. Month의 값은 1만큼 오프셋되어 계산된 연도의 1월에 적용됩니다. 즉, (Month - 1)이 1월에 더해집니다. 필요한 경우에는 연도가 다시 계산됩니다. 다음은 Day 값이 계산된 결과입니다.

Month가 1이면 계산된 연도의 1월입니다.

Month가 0이면 이전 연도의 12월입니다.

Month가 -1이면 이전 연도의 11월입니다.

Month가 13이면 다음 연도의 1월입니다.

Day
Int32

필수 요소. 1에서 31까지의 정수 식입니다. 그러나 이 범위를 벗어나는 값도 사용할 수 있습니다. Day의 값은 1만큼 오프셋되어 계산된 월의 1일에 적용됩니다. 즉, (Day- 1)이 해당 월의 1일에 더해집니다. 필요한 경우에는 월과 연도가 다시 계산됩니다. 다음은 Day 값이 계산된 결과입니다.

Day가 1이면 계산된 월의 1일입니다.

Day가 0이면 이전 월의 마지막 날짜입니다.

Day가 -1이면 이전 월의 끝에서 두 번째 날짜입니다.

Day가 현재 월의 마지막 날짜 값을 넘으면 다음 월의 해당되는 날짜입니다. 예를 들어, Month가 4이고 Day가 31이면 5월 1일입니다.

반환

시간 정보가 자정(00:00:00)으로 설정된 지정된 연도, 월 및 일을 나타내는 값입니다.

예제

이 예제에서는 함수를 DateSerial 사용하여 지정된 연도, 월 및 일의 날짜를 반환합니다.

' DateSerial returns the date for a specified year, month, and day.
Dim aDate As Date
' Variable aDate contains the date for February 12, 1969.
aDate = DateSerial(1969, 2, 12)
Console.WriteLine(aDate)

' The following example uses DateSerial to determine and display
' the last day of the previous month.
' First, establish a starting date.
Dim startDate = #1/23/1994#
' The 0 for the day represents the last day of the previous month.
Dim endOfLastMonth = DateSerial(startDate.Year, startDate.Month, 0)
Console.WriteLine("Last day in the previous month: " & endOfLastMonth)

' The following example finds and displays the day of the week that the 
' 15th day of the following month will fall on.
Dim fifteenthsDay = DateSerial(Today.Year, Today.Month + 1, 15)
Console.WriteLine("The 15th of next month is a {0}", fifteenthsDay.DayOfWeek)

설명

인수에 Year 대한 두 자리 값은 사용자 정의 컴퓨터 설정에 따라 해석됩니다. 기본 설정은 0에서 29까지의 값이 2000-2029년으로 해석되고 30에서 99까지의 값은 1930-1999년으로 해석됩니다. 다른 모든 연도를 나타내려면 4자리 연도(예: 1924)를 사용합니다.

다음 예제에서는 음수, 0 및 양수 인수 값을 보여 줍니다. 여기서 함수는 DateSerial 현재 연도 10년 전의 3월 첫째 날, 즉 10년 전 2월의 마지막 날을 나타내는 을 반환 Date 합니다.

Dim EndFeb As Date = DateSerial(-10, 3, 0)  

Month 또는 Day 가 정상 범위를 초과하는 경우 다음 큰 단위에 적절하게 적용됩니다. 예를 들어 32일을 지정하면 값 Month에 따라 1개월에서 4일로 평가됩니다. Year 가 9999보다 크거나 인수가 -2,147,483,648부터 2,147,483,647 ArgumentException 까지 범위를 벗어나면 오류가 발생합니다. 세 인수로 지정된 날짜가 1년 1월 1일 00:00:00보다 이전이거나 9999 ArgumentOutOfRangeException 년 12월 31일 23:59:59보다 낫으면 오류가 발생합니다.

데이터 형식에는 Date 시간 구성 요소가 포함됩니다. DateSerial 는 이러한 모든 값을 0으로 설정하므로 반환된 값은 계산된 날짜의 시작을 나타냅니다.

모든 Date 값은 구조체에서 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)  

적용 대상

추가 정보