지정된 날짜의 특정 부분이 들어 있는 Variant(Integer)를 반환합니다.
| 경고 이 함수를 사용하는 데 문제가 있습니다. 일부 연도의 마지막 월요일은 1주차여야 하는데 53주차로 반환될 수 있습니다. 자세한 내용 및 해결 방법은 Format 또는 DatePart 함수가 연도의 마지막 월요일에 대해 잘못된 주 번호를 반환할 수 있음을 참조하세요. |
|---|
구문
DatePart(interval, date [, firstdayofweek] [, firstweekofyear] )
DatePart 함수 구문에는 다음과 같은 인수가 사용됩니다.
| 인수 | 설명 |
|---|---|
| interval | 필수 요소입니다. 반환하려는 시간 간격인 문자열 식입니다. |
| 날짜 | 필수 요소입니다. 평가할 변형(날짜) 값입니다. |
| firstdayofweek | 선택 요소입니다. 요일의 첫 번째 요일을 지정하는 상수입니다. 지정하지 않으면 일요일로 간주됩니다. |
| FirstWeekOfYear | 선택 요소입니다. 연도의 첫 번째 주를 지정하는 상수입니다. 지정하지 않으면 첫 번째 주를 1월 1일이 발생하는 주로 간주합니다. |
설정
interval 인수에는 다음과 같은 설정이 있습니다.
| 설정 | 설명 |
|---|---|
| yyyy | 년 |
| q | 분기 |
| m | 월 |
| y | 연중 날짜 |
| d | 일 |
| w | Weekday |
| ww | 주 |
| h | 시간 |
| n | 분 |
| s | 초 |
firstdayofweek 인수에는 다음과 같은 설정이 있습니다.
| 상수 | Value | 설명 |
|---|---|---|
| vbUseSystem | 0 | NLS API 설정을 사용합니다. |
| vbSunday | 1 | 일요일(기본값) |
| vbMonday | 2 | 월요일 |
| vbTuesday | 3 | 화요일 |
| vbWednesday | 4 | 수요일 |
| vbThursday | 5 | 목요일 |
| vbFriday | 6 | 금요일 |
| vbSaturday | 7 | 토요일 |
firstweekofyear 인수에는 다음과 같은 설정이 있습니다.
| 상수 | Value | 설명 |
|---|---|---|
| vbUseSystem | 0 | NLS API 설정을 사용합니다. |
| vbFirstJan1 | 1 | 1월 1일이 발생하는 주부터 시작합니다(기본값). |
| vbFirstFourDays | 2 | 새해에 최소 4일이 있는 첫 주부터 시작합니다. |
| vbFirstFullWeek | 3 | 연도의 첫 주부터 시작합니다. |
주의
DatePart 함수를 사용하여 날짜를 계산하고 특정 시간 간격을 반환할 수 있습니다. 예를 들어 DatePart 를 사용하여 요일이나 현재 시간을 계산할 수 있습니다.
firstdayofweek 인수는 "w" 및 "ww" 간격 기호를 사용하는 계산에 영향을 줍니다.
날짜가 날짜 리터럴인 경우 지정된 연도는 해당 날짜의 영구적인 부분이 됩니다. 그러나 날짜 를 큰따옴표(" ")로 묶고 연도를 생략하면 날짜 식이 계산될 때마다 현재 연도가 코드에 삽입됩니다. 이를 통해 다른 연도에 사용할 수 있는 코드를 작성할 수 있습니다.
참고
날짜의 경우 Calendar 속성 설정이 양력인 경우 제공되는 날짜는 양력이어야 합니다. 일정이 회교식인 경우 제공된 날짜는 회교식이어야 합니다.
반환된 날짜 부분은 현재 아랍 달력의 기간 단위입니다. 예를 들어 현재 달력이 회교식이고 반환될 날짜 부분이 연도인 경우 연도 값은 회교식 연도입니다.
쿼리 예제
| Expression | 결과 |
|---|---|
| SELECT DatePart("yyyy",[DateofSale]) AS NewDate FROM ProductSales; | "DateofSale" 필드의 날짜 값에서 '연도'를 반환합니다. |
| SELECT DatePart("q",[DateofSale]) AS NewDate FROM ProductSales; | "DateofSale" 필드 날짜 값의 '분기'(캘린더 연도 기준)를 반환합니다. |
| SELECT DatePart("y",[DateofSale]) AS NewDate FROM ProductSales; | "DateofSale" 필드의 날짜 값 중 '연도의 날짜'(1에서 365까지)를 반환합니다. |
| SELECT DatePart("d",[DateofSale]) AS NewDate FROM ProductSales; | "DateofSale" 필드의 날짜 값 '일'을 반환합니다. |
| SELECT DatePart("w",[DateofSale]) AS NewDate FROM ProductSales; | "DateofSale" 필드 날짜 값의 '요일'(1부터 7까지, 여기서 1은 일요일을 나타냄)을 반환합니다. |
| SELECT DatePart("ww",[DateofSale]) AS NewDate FROM ProductSales; | "DateofSale" 필드의 날짜 값 중 '주 번호'(1에서 52까지)를 반환합니다. |
| SELECT DatePart("h",[DateTime]) AS NewDate FROM ProductSales; | "DateTime" 필드의 날짜 값 중 '시간'을 반환합니다. |
| SELECT DatePart("n",[DateTime]) AS NewDate FROM ProductSales; | "DateTime" 필드의 날짜 값에서 '분'을 반환합니다. |
| SELECT DatePart("s",[DateTime]) AS NewDate FROM ProductSales; | "DateTime" 필드 날짜 값의 '초'를 반환합니다. |
VBA 예제
참고
VBA(Visual Basic for Applications) 모듈에서 이 함수를 사용하는 경우를 예로 들어 보겠습니다. VBA 사용에 대해 자세히 알아보려면 검색 옆의 드롭다운 목록에서 개발자 참고를 선택하고 검색 상자에 검색어를 하나 이상 입력하세요.
이 예제에서는 날짜를 가져와서 DatePart 함수를 사용하여 해당 날짜가 발생한 연도의 분기를 표시합니다.
Dim TheDate As Date ' Declare variables.
Dim Msg
TheDate = InputBox("Enter a date:")
Msg = "Quarter: " & DatePart("q", TheDate)
MsgBox Msg