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

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

매개 변수

반품

시간 정보가 자정(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)

추가 정보

• DateValue(String)
• Day(DateTime)
• Month(DateTime)
• Now
• TimeSerial(Int32, Int32, Int32)
• TimeValue(String)
• Weekday(DateTime, FirstDayOfWeek)
• Year(DateTime)
• System
• 데이터 형식 요약(Visual Basic)