DateAndTime.DatePart 메서드
정의
중요
일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.
지정된 Date 값의 지정된 구성 요소를 포함하는 정수 값을 반환합니다.
오버로드
| DatePart(DateInterval, DateTime, FirstDayOfWeek, FirstWeekOfYear) |
지정된 |
| DatePart(String, Object, FirstDayOfWeek, FirstWeekOfYear) |
지정된 |
DatePart(DateInterval, DateTime, FirstDayOfWeek, FirstWeekOfYear)
- Source:
- DateAndTime.vb
- Source:
- DateAndTime.vb
- Source:
- DateAndTime.vb
지정된 Date 값의 지정된 구성 요소를 포함하는 정수 값을 반환합니다.
public static int DatePart (Microsoft.VisualBasic.DateInterval Interval, DateTime DateValue, Microsoft.VisualBasic.FirstDayOfWeek FirstDayOfWeekValue = Microsoft.VisualBasic.FirstDayOfWeek.Sunday, Microsoft.VisualBasic.FirstWeekOfYear FirstWeekOfYearValue = Microsoft.VisualBasic.FirstWeekOfYear.Jan1);static member DatePart : Microsoft.VisualBasic.DateInterval * DateTime * Microsoft.VisualBasic.FirstDayOfWeek * Microsoft.VisualBasic.FirstWeekOfYear -> intPublic Function DatePart (Interval As DateInterval, DateValue As DateTime, Optional FirstDayOfWeekValue As FirstDayOfWeek = Microsoft.VisualBasic.FirstDayOfWeek.Sunday, Optional FirstWeekOfYearValue As FirstWeekOfYear = Microsoft.VisualBasic.FirstWeekOfYear.Jan1) As Integer매개 변수
- Interval
- DateInterval
필수. 반환하려는 날짜/시간 값의 일부를 나타내는 DateInterval 열거형 값 또는 문자열 식입니다.
- DateValue
- DateTime
필수. 평가할 Date 값입니다.
- FirstDayOfWeekValue
- FirstDayOfWeek
선택적. 요일을 지정하는 FirstDayOfWeek 열거형에서 선택한 값입니다. 지정하지 않으면 Sunday 사용됩니다.
- FirstWeekOfYearValue
- FirstWeekOfYear
선택적. 연도의 첫 번째 주를 지정하는 FirstWeekOfYear 열거형에서 선택한 값입니다. 지정하지 않으면 Jan1 사용됩니다.
반환
지정된 Date 값의 지정된 구성 요소를 포함하는 정수 값입니다.
예외
Interval 잘못되었습니다.
DateValue
Date강제 변환할 수 없습니다.
예제
이 예제에서는 날짜를 사용하고 DatePart 함수를 사용하여 해당 날짜가 발생하는 연도의 분기를 표시합니다.
Dim DateString, Msg As String
Dim ActualDate As Date
' Enter February 12, 2008, or 2/12/2008.
DateString = InputBox("Enter a date:")
ActualDate = CDate(DateString)
' The first two examples use enumeration values for the interval.
Msg = "Quarter: " & DatePart(DateInterval.Quarter, ActualDate)
' The quarter is 1.
MsgBox(Msg)
Msg = "The day of the month: " & DatePart(DateInterval.Day, ActualDate)
' The day of the month is 12.
MsgBox(Msg)
' The next two examples use string values for the interval parameter.
Msg = "The week of the year: " & DatePart("ww", ActualDate)
' The week of the year is 7.
MsgBox(Msg)
Msg = "The day of the week: " & DatePart("w", ActualDate)
' The day of the week is 3 (Tuesday).
MsgBox(Msg)
설명
DatePart 함수를 사용하여 날짜/시간 값을 평가하고 특정 구성 요소를 반환할 수 있습니다. 예를 들어 DatePart 사용하여 요일 또는 현재 시간을 계산할 수 있습니다.
Interval 인수에 대한 DateInterval.Weekday 선택하면 반환된 값은 FirstDayOfWeek 열거형의 값과 일치합니다.
DateInterval.WeekOfYear선택하는 경우 DatePartSystem.Globalization 네임스페이스의 Calendar 및 CultureInfo 클래스를 사용하여 현재 설정을 결정합니다.
FirstDayOfWeekValue 인수는 DateInterval.Weekday 및 DateInterval.WeekOfYearInterval 설정을 사용하는 계산에 영향을 줍니다.
FirstWeekOfYearValue 인수는 IntervalDateInterval.WeekOfYear 지정하는 계산에 영향을 줍니다.
모든 Date 값은 DateTime 구조에서 지원되므로 해당 메서드는 날짜/시간 부분을 검색하는 추가 옵션을 제공합니다. 예를 들어 다음과 같이 시간 값을 자정으로 설정하여 Date 변수의 전체 날짜 값을 가져올 수 있습니다.
Dim CurrDatTim As Date = Now ' Current date and time.
Dim LastMidnight As Date = CurrDatTim.Date ' At midnight.
Interval 인수는 다음 설정 중 하나를 가질 수 있습니다.
| 열거형 값 | 문자열 | 반환할 날짜/시간 값의 일부 |
|---|---|---|
DateInterval.Day |
d | 월의 날(1~31) |
DateInterval.DayOfYear |
y | 연중 일(1~366) |
DateInterval.Hour |
h | 시 |
DateInterval.Minute |
n | 분 |
DateInterval.Month |
m | 달 |
DateInterval.Quarter |
q | 사분의 일 |
DateInterval.Second |
s | 초 |
DateInterval.Weekday |
w | 요일(1~7) |
DateInterval.WeekOfYear |
ww | 연도 주(1~53) |
DateInterval.Year |
yyyy | 년 |
FirstDayOfWeekValue 인수는 다음 설정 중 하나를 가질 수 있습니다.
| 열거형 값 | 값 | 묘사 |
|---|---|---|
FirstDayOfWeek.System |
0 | 시스템 설정에 지정된 요일 1일 |
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 | 새해 첫 번째 전체 주 |
추가 정보
- DateAdd
- DateDiff
- Day(DateTime)
- Format(Object, String)
- Now
- Weekday(DateTime, FirstDayOfWeek)
- Year(DateTime)
- System
- 데이터 형식 요약(Visual Basic)
적용 대상
DatePart(String, Object, FirstDayOfWeek, FirstWeekOfYear)
- Source:
- DateAndTime.vb
- Source:
- DateAndTime.vb
- Source:
- DateAndTime.vb
지정된 Date 값의 지정된 구성 요소를 포함하는 값을 반환합니다.
public static int DatePart (string Interval, object? DateValue, Microsoft.VisualBasic.FirstDayOfWeek DayOfWeek = Microsoft.VisualBasic.FirstDayOfWeek.Sunday, Microsoft.VisualBasic.FirstWeekOfYear WeekOfYear = Microsoft.VisualBasic.FirstWeekOfYear.Jan1);public static int DatePart (string Interval, object DateValue, Microsoft.VisualBasic.FirstDayOfWeek DayOfWeek = Microsoft.VisualBasic.FirstDayOfWeek.Sunday, Microsoft.VisualBasic.FirstWeekOfYear WeekOfYear = Microsoft.VisualBasic.FirstWeekOfYear.Jan1);static member DatePart : string * obj * Microsoft.VisualBasic.FirstDayOfWeek * Microsoft.VisualBasic.FirstWeekOfYear -> intPublic Function DatePart (Interval As String, DateValue As Object, Optional DayOfWeek As FirstDayOfWeek = Microsoft.VisualBasic.FirstDayOfWeek.Sunday, Optional WeekOfYear As FirstWeekOfYear = Microsoft.VisualBasic.FirstWeekOfYear.Jan1) As Integer매개 변수
- Interval
- String
필수. 반환하려는 날짜/시간 값의 일부를 나타내는 DateInterval 열거형 값 또는 문자열 식입니다.
- DateValue
- Object
필수. 평가할 Date 값입니다.
- DayOfWeek
- FirstDayOfWeek
선택적. 요일을 지정하는 FirstDayOfWeek 열거형에서 선택한 값입니다. 지정하지 않으면 Sunday 사용됩니다.
- WeekOfYear
- FirstWeekOfYear
선택적. 연도의 첫 번째 주를 지정하는 FirstWeekOfYear 열거형에서 선택한 값입니다. 지정하지 않으면 Jan1 사용됩니다.
반환
지정된 Date 값의 지정된 구성 요소를 포함하는 정수 값입니다.
예외
Interval 잘못되었습니다.
DateValue
Date강제 변환할 수 없습니다.
예제
이 예제에서는 날짜를 사용하고 DatePart 함수를 사용하여 해당 날짜가 발생하는 연도의 분기를 표시합니다.
Dim DateString, Msg As String
Dim ActualDate As Date
' Enter February 12, 2008, or 2/12/2008.
DateString = InputBox("Enter a date:")
ActualDate = CDate(DateString)
' The first two examples use enumeration values for the interval.
Msg = "Quarter: " & DatePart(DateInterval.Quarter, ActualDate)
' The quarter is 1.
MsgBox(Msg)
Msg = "The day of the month: " & DatePart(DateInterval.Day, ActualDate)
' The day of the month is 12.
MsgBox(Msg)
' The next two examples use string values for the interval parameter.
Msg = "The week of the year: " & DatePart("ww", ActualDate)
' The week of the year is 7.
MsgBox(Msg)
Msg = "The day of the week: " & DatePart("w", ActualDate)
' The day of the week is 3 (Tuesday).
MsgBox(Msg)
설명
DatePart 함수를 사용하여 날짜/시간 값을 평가하고 특정 구성 요소를 반환할 수 있습니다. 예를 들어 DatePart 사용하여 요일 또는 현재 시간을 계산할 수 있습니다.
Interval 인수에 대한 DateInterval.Weekday 선택하면 반환된 값은 FirstDayOfWeek 열거형의 값과 일치합니다.
DateInterval.WeekOfYear선택하는 경우 DatePartSystem.Globalization 네임스페이스의 Calendar 및 CultureInfo 클래스를 사용하여 현재 설정을 결정합니다.
FirstDayOfWeekValue 인수는 DateInterval.Weekday 및 DateInterval.WeekOfYearInterval 설정을 사용하는 계산에 영향을 줍니다.
FirstWeekOfYearValue 인수는 IntervalDateInterval.WeekOfYear 지정하는 계산에 영향을 줍니다.
모든 Date 값은 DateTime 구조에서 지원되므로 해당 메서드는 날짜/시간 부분을 검색하는 추가 옵션을 제공합니다. 예를 들어 다음과 같이 시간 값을 자정으로 설정하여 Date 변수의 전체 날짜 값을 가져올 수 있습니다.
Dim CurrDatTim As Date = Now ' Current date and time.
Dim LastMidnight As Date = CurrDatTim.Date ' At midnight.
Interval 인수는 다음 설정 중 하나를 가질 수 있습니다.
| 열거형 값 | 문자열 | 반환할 날짜/시간 값의 일부 |
|---|---|---|
DateInterval.Day |
d | 월의 날(1~31) |
DateInterval.DayOfYear |
y | 연중 일(1~366) |
DateInterval.Hour |
h | 시 |
DateInterval.Minute |
n | 분 |
DateInterval.Month |
m | 달 |
DateInterval.Quarter |
q | 사분의 일 |
DateInterval.Second |
s | 초 |
DateInterval.Weekday |
w | 요일(1~7) |
DateInterval.WeekOfYear |
ww | 연도 주(1~53) |
DateInterval.Year |
yyyy | 년 |
FirstDayOfWeekValue 인수는 다음 설정 중 하나를 가질 수 있습니다.
| 열거형 값 | 값 | 묘사 |
|---|---|---|
FirstDayOfWeek.System |
0 | 시스템 설정에 지정된 요일 1일 |
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 | 새해 첫 번째 전체 주 |
추가 정보
- DateAdd
- DateDiff
- Day(DateTime)
- Format(Object, String)
- Now
- Weekday(DateTime, FirstDayOfWeek)
- Year(DateTime)
- System
- 데이터 형식 요약(Visual Basic)
적용 대상
.NET