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경우 네임스페이 Calendar 스의 및 CultureInfo 클래스를 System.Globalization 사용하여 현재 설정을 결정 DatePart 합니다.
인수는 FirstDayOfWeekValue 및 DateInterval.WeekOfYearInterval 설정을 사용하는 계산에 DateInterval.Weekday 영향을 줍니다. 인수는 FirstWeekOfYearValue 에 대해 를 지정 DateInterval.WeekOfYear 하는 계산에 Interval영향을 줍니다.
모든 Date 값은 구조체에서 DateTime 지원되므로 해당 메서드는 날짜/시간 부분을 검색하는 추가 옵션을 제공합니다. 예를 들어 다음과 같이 시간 값을 자정으로 설정하여 변수의 Date 전체 날짜 값을 가져올 수 있습니다.
Dim CurrDatTim As Date = Now ' Current date and time.
Dim LastMidnight As Date = CurrDatTim.Date ' At midnight.
인수에는 Interval 다음 설정 중 하나가 있을 수 있습니다.
| 열거형 값 | String | 반환할 날짜/시간 값의 일부 |
|---|---|---|
DateInterval.Day |
일 | 월간 일자(1~31) |
DateInterval.DayOfYear |
y | 연간 일자(1~366) |
DateInterval.Hour |
h | 시간 |
DateInterval.Minute |
n | Minute |
DateInterval.Month |
분 | 월 |
DateInterval.Quarter |
q | Quarter |
DateInterval.Second |
초 | Second |
DateInterval.Weekday |
w | 요일(1~7) |
DateInterval.WeekOfYear |
ww | 연간 주(1~53) |
DateInterval.Year |
yyyy | Year |
인수에는 FirstDayOfWeekValue 다음 설정 중 하나가 있을 수 있습니다.
| 열거형 값 | 값 | Description |
|---|---|---|
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 다음 설정 중 하나가 있을 수 있습니다.
| 열거형 값 | 값 | Description |
|---|---|---|
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경우 네임스페이 Calendar 스의 및 CultureInfo 클래스를 System.Globalization 사용하여 현재 설정을 결정 DatePart 합니다.
인수는 FirstDayOfWeekValue 및 DateInterval.WeekOfYearInterval 설정을 사용하는 계산에 DateInterval.Weekday 영향을 줍니다. 인수는 FirstWeekOfYearValue 에 대해 를 지정 DateInterval.WeekOfYear 하는 계산에 Interval영향을 줍니다.
모든 Date 값은 구조체에서 DateTime 지원되므로 해당 메서드는 날짜/시간 부분을 검색하는 추가 옵션을 제공합니다. 예를 들어 다음과 같이 시간 값을 자정으로 설정하여 변수의 Date 전체 날짜 값을 가져올 수 있습니다.
Dim CurrDatTim As Date = Now ' Current date and time.
Dim LastMidnight As Date = CurrDatTim.Date ' At midnight.
인수에는 Interval 다음 설정 중 하나가 있을 수 있습니다.
| 열거형 값 | String | 반환할 날짜/시간 값의 일부 |
|---|---|---|
DateInterval.Day |
일 | 월간 일자(1~31) |
DateInterval.DayOfYear |
y | 연간 일자(1~366) |
DateInterval.Hour |
h | 시간 |
DateInterval.Minute |
n | Minute |
DateInterval.Month |
분 | 월 |
DateInterval.Quarter |
q | Quarter |
DateInterval.Second |
초 | Second |
DateInterval.Weekday |
w | 요일(1~7) |
DateInterval.WeekOfYear |
ww | 연간 주(1~53) |
DateInterval.Year |
yyyy | Year |
인수에는 FirstDayOfWeekValue 다음 설정 중 하나가 있을 수 있습니다.
| 열거형 값 | 값 | Description |
|---|---|---|
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 다음 설정 중 하나가 있을 수 있습니다.
| 열거형 값 | 값 | Description |
|---|---|---|
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
피드백
출시 예정: 2024년 내내 콘텐츠에 대한 피드백 메커니즘으로 GitHub 문제를 단계적으로 폐지하고 이를 새로운 피드백 시스템으로 바꿀 예정입니다. 자세한 내용은 다음을 참조하세요. https://aka.ms/ContentUserFeedback
다음에 대한 사용자 의견 제출 및 보기