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 -> int
Public 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.WeekOfYear
Interval
설정을 사용하는 계산에 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 -> int
Public 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.WeekOfYear
Interval
설정을 사용하는 계산에 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
피드백
https://aka.ms/ContentUserFeedback
출시 예정: 2024년 내내 콘텐츠에 대한 피드백 메커니즘으로 GitHub 문제를 단계적으로 폐지하고 이를 새로운 피드백 시스템으로 바꿀 예정입니다. 자세한 내용은 다음을 참조하세요.다음에 대한 사용자 의견 제출 및 보기