DateAndTime.DatePart 메서드

정의

네임스페이스:: Microsoft.VisualBasic

어셈블리:: Microsoft.VisualBasic.dll

중요

일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.

지정된 Date 값의 지정된 구성 요소를 포함하는 정수 값을 반환합니다.

오버로드

Name	Description
DatePart(DateInterval, DateTime, FirstDayOfWeek, FirstWeekOfYear)	지정된 `Date` 값의 지정된 구성 요소를 포함하는 정수 값을 반환합니다.
DatePart(String, Object, FirstDayOfWeek, FirstWeekOfYear)	지정된 `Date` 값의 지정된 구성 요소를 포함하는 값을 반환합니다.

DatePart(DateInterval, DateTime, FirstDayOfWeek, FirstWeekOfYear)

지정된 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

Optional. 요일을 FirstDayOfWeek 지정하는 열거형에서 선택한 값입니다. 지정되지 않은 경우 Sunday가 사용됩니다.

FirstWeekOfYearValue: FirstWeekOfYear

Optional. 연도의 FirstWeekOfYear 첫 번째 주를 지정하는 열거형에서 선택한 값입니다. 지정되지 않은 경우 Jan1가 사용됩니다.

반품

Int32

지정된 Date 값의 지정된 구성 요소를 포함하는 정수 값입니다.

예외

ArgumentException

Interval 가 잘못되었습니다.

InvalidCastException

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.WeekOfYearDatePart 경우 네임스페이 Calendar 스의 클래스 및 CultureInfo 클래스를 System.Globalization 사용하여 현재 설정을 결정합니다.

인수는 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 다음 설정 중 하나가 있을 수 있습니다.

열거형 값	스트링	반환할 날짜/시간 값의 일부
`DateInterval.Day`	d	월의 날(1~31)
`DateInterval.DayOfYear`	Y	연중 일(1~366)
`DateInterval.Hour`	시간	시간
`DateInterval.Minute`	n	분
`DateInterval.Month`	m	Month
`DateInterval.Quarter`	q	분기
`DateInterval.Second`	s	2분기
`DateInterval.Weekday`	w	요일(1~7)
`DateInterval.WeekOfYear`	ww	연도 주(1~53)
`DateInterval.Year`	yyyy	년

인수에는 FirstDayOfWeekValue 다음 설정 중 하나가 있을 수 있습니다.

열거형 값	Value	Description
`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 다음 설정 중 하나가 있을 수 있습니다.

열거형 값	Value	Description
`FirstWeekOfYear.System`	0	시스템 설정에 지정된 연도의 첫 번째 주
`FirstWeekOfYear.Jan1`	1	1월 1일이 발생하는 주(기본값)
`FirstWeekOfYear.FirstFourDays`	2	새해에 최소 4일이 있는 주(ISO 표준 8601, 섹션 3.17 준수)
`FirstWeekOfYear.FirstFullWeek`	3	새해 첫 번째 전체 주

추가 정보

적용 대상

DatePart(String, Object, FirstDayOfWeek, FirstWeekOfYear)

지정된 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);

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