DatePart 함수(Visual Basic)
업데이트: 2007년 11월
특정 Date 값의 지정된 구성 요소가 들어 있는 Integer 값을 반환합니다.
Public Overloads Function DatePart( _
ByVal Interval As DateInterval, _
ByVal DateValue As DateTime, _
Optional ByVal FirstDayOfWeekValue As FirstDayOfWeek = VbSunday, _
Optional ByVal FirstWeekOfYearValue As FirstWeekOfYear = VbFirstJan1 _
) As Integer
' -or-
Public Overloads Function DatePart( _
ByVal Interval As String, _
ByVal DateValue As Object, _
Optional ByVal DayOfWeek As FirstDayOfWeek = FirstDayOfWeek.Sunday, _
Optional ByVal WeekOfYear As FirstWeekOfYear = FirstWeekOfYear.Jan1 _
) As Integer
매개 변수
Interval
필수적 요소. 반환할 날짜/시간 값의 부분을 나타내는 DateInterval 열거형 값 또는 String 식입니다.DateValue
필수적 요소. 계산할 Date 값입니다.FirstDayOfWeekValue, DayOfWeek
선택적 요소. 주의 첫째 요일을 지정하는 FirstDayOfWeek 열거형에서 선택한 값입니다. 값을 지정하지 않으면 FirstDayOfWeek.Sunday가 사용됩니다.FirstWeekOfYearValue, WeekOfYear
선택적 요소. 해당 연도의 첫째 주를 지정하는 FirstWeekOfYear 열거형에서 선택한 값입니다. 값을 지정하지 않으면 FirstWeekOfYear.Jan1이 사용됩니다.
설정
Interval 인수의 설정은 다음과 같습니다.
열거형 값 |
문자열 |
반환할 날짜/시간 값의 부분 |
|---|---|---|
DateInterval.Day |
d |
일(월 기준: 1 - 31) |
DateInterval.DayOfYear |
y |
일(연도 기준: 1 - 366) |
DateInterval.Hour |
h |
Hour |
DateInterval.Minute |
n |
Minute |
DateInterval.Month |
m |
Month |
DateInterval.Quarter |
q |
분기 |
DateInterval.Second |
s |
Second |
DateInterval.Weekday |
w |
일(주 기준: 1 - 7) |
DateInterval.WeekOfYear |
ww |
주(연도 기준: 1 - 53) |
DateInterval.Year |
yyyy |
Year |
FirstDayOfWeekValue 인수의 설정은 다음과 같습니다.
열거형 값 |
값 |
설명 |
|---|---|---|
FirstDayOfWeek.System |
0 |
시스템 설정에 지정된 주의 첫째 요일 |
FirstDayOfWeek.Sunday |
1 |
일요일(기본값) |
FirstDayOfWeek.Monday |
2 |
월요일(ISO 표준 8601, 3.17조항을 따름) |
FirstDayOfWeek.Tuesday |
3 |
화요일 |
FirstDayOfWeek.Wednesday |
4 |
수요일 |
FirstDayOfWeek.Thursday |
5 |
목요일 |
FirstDayOfWeek.Friday |
6 |
금요일 |
FirstDayOfWeek.Saturday |
7 |
토요일 |
FirstWeekOfYearValue 인수의 설정은 다음과 같습니다.
열거형 값 |
값 |
설명 |
|---|---|---|
FirstWeekOfYear.System |
0 |
시스템 설정에 지정된 연도의 첫째 주 |
FirstWeekOfYear.Jan1 |
1 |
1월 1일이 속하는 주(기본값) |
FirstWeekOfYear.FirstFourDays |
2 |
주 중 4일 이상이 새로운 연도에 속하는 주(ISO 표준 8601, 3.17 조항을 따름) |
FirstWeekOfYear.FirstFullWeek |
3 |
새로운 연도에서 완전한 첫째 주 |
예외
예외 형식 |
오류 번호 |
조건 |
|---|---|---|
Interval이 잘못되었습니다. |
||
DateValue가 Date로 강제 변환될 수 없습니다. |
비구조적 오류 처리를 사용하는 Visual Basic 6.0 응용 프로그램을 업그레이드하는 경우에는 "오류 번호" 열을 참조하십시오. 오류 번호를 Number 속성(Err 개체)과 비교할 수 있습니다. 그러나 가능하면 이러한 오류 제어 방법을 Visual Basic의 구조적 예외 처리 개요에 설명된 방식으로 바꾸는 것이 좋습니다.
설명
DatePart 함수를 사용하면 날짜/시간 값을 계산하고 특정 구성 요소를 반환할 수 있습니다. 예를 들어, DatePart를 사용하여 요일이나 현재 시간을 계산할 수 있습니다.
Interval 인수에 대해 DateInterval.Weekday를 선택하는 경우 반환된 값은 FirstDayOfWeek 열거형의 값과 일치합니다. DateInterval.WeekOfYear를 선택하면 DatePart에서 System.Globalization 네임스페이스의 Calendar 및 CultureInfo 클래스를 사용하여 현재 설정을 확인합니다.
FirstDayOfWeekValue 인수는 DateInterval.Weekday와 DateInterval.WeekOfYear Interval 설정을 사용하는 계산에 영향을 줍니다. FirstWeekOfYearValue 인수는 Interval에 대해 DateInterval.WeekOfYear를 지정하는 계산에 영향을 줍니다.
DateTime 구조체에서는 모든 Date 값을 지원하므로 해당 메서드에는 날짜/시간 부분을 검색하는 데 사용할 수 있는 추가 옵션이 있습니다. 예를 들어, 다음과 같이 시간 값을 자정으로 설정하여 Date 변수의 전체 날짜 값을 구할 수 있습니다.
Dim CurrDatTim As Date = Now ' Current date and time.
Dim LastMidnight As Date = CurrDatTim.Date ' At midnight.
예제
다음 예제에서는 DatePart 함수를 사용하여 입력된 날짜가 속한 연도의 분기를 표시합니다.
Dim FirstDate, Msg As String 'Declare variables.
Dim SecondDate As Date
FirstDate = InputBox("Enter a date:")
SecondDate = CDate(FirstDate)
Msg = "Quarter: " & DatePart(DateInterval.Quarter, SecondDate)
MsgBox(Msg)
요구 사항
네임스페이스: Microsoft.VisualBasic
**모듈:**DateAndTime
**어셈블리:**Visual Basic 런타임 라이브러리(Microsoft.VisualBasic.dll)