지정된 날짜의 특정 부분이 들어 있는 Variant(Integer)를 반환합니다.
|
경고 이 함수를 사용 하는 데 문제가 있습니다. 일부 일정 연도의 마지막 월은 주 1 일 때 53 주 단위로 반환 될 수 있습니다. 자세한 내용 및 해결 방법에 대 한 자세한 내용은 Format 또는 DatePart 함수를 통해 작년의 마지막 월요일에 대 한 잘못 된 주 번호를 반환할 수 있습니다. |
구문
DatePart ( interval, date [, firstdayofweek] [, firstweekofyear] )
DatePart 함수 구문에는 다음과 같은 인수가 사용 됩니다.
인수 | 설명 |
|---|---|
|
interval |
필수 요소입니다. 반환 하려는 시간 간격을 나타내는 문자열 식입니다. |
|
date |
필수 요소입니다. 계산 하려는 Variant (Date) 값입니다. |
|
firstdayofweek |
선택 요소입니다. 주의 시작 요일을 지정 하는 상수 입니다. 지정 하지 않으면 일요일로 간주 됩니다. |
|
firstweekofyear |
선택 요소입니다. 연도의 시작 주를 지정 하는 상수입니다. 지정 하지 않으면 첫 번째 주가 1 월 1 일이 발생 하는 주로 간주 됩니다. |
설정
Interval 인수에는 다음과 같은 설정이 있습니다.
설정 | 설명 |
|---|---|
|
yyyy |
연도 |
|
q |
분기 |
|
m |
월 |
|
y |
연간 일 |
|
d |
일 |
|
w |
Weekday |
|
ww |
주 |
|
h |
시간 |
|
n |
분 |
|
s |
초 |
Firstdayofweek 인수에는 다음과 같은 설정이 있습니다.
상수 | 값 | 설명 |
|---|---|---|
|
vbUseSystem |
0 |
NLS API 설정을 사용 합니다. |
|
vbSunday |
1 |
일요일 (기본값) |
|
vbMonday |
2 |
월요일 |
|
vbTuesday |
3 |
화요일 |
|
vbWednesday |
4 |
수요일 |
|
vbThursday |
5 |
목요일 |
|
vbFriday |
6 |
금요일 |
|
vbSaturday |
7 |
토요일 |
Firstweekofyear 인수에는 다음과 같은 설정이 있습니다.
상수 | 값 | 설명 |
|---|---|---|
|
vbUseSystem |
0 |
NLS API 설정을 사용 합니다. |
|
vbFirstJan1 |
1 |
1 월 1 일이 있는 주부터 시작 합니다 (기본값). |
|
vbFirstFourDays |
2 |
새 해에 최소 4 일이 포함 된 첫 번째 주부터 시작 합니다. |
|
vbFirstFullWeek |
3 |
해당 연도의 처음 전체 주부터 시작 합니다. |
주의
DatePart 함수를 사용 하 여 날짜를 계산 하 고 특정 시간 간격을 반환할 수 있습니다. 예를 들어 DatePart 를 사용 하 여 요일 또는 현재 시간을 계산할 수 있습니다.
Firstdayofweek 인수는 "w" 및 "ww" 간격 기호를 사용 하는 계산에 영향을 줍니다.
Da te 가 날짜 리터럴 이면 지정 된 연도가 해당 날짜의 영구 부분이 됩니다. 그러나 date 가 큰따옴표 ("")로 묶여 있는 경우 연도를 생략 하면 날짜 식이 계산 될 때마다 현재 연도가 코드에 삽입 됩니다. 이를 통해 다른 연도에서 사용할 수 있는 코드를 작성 하는 것이 가능 합니다.
참고: 날짜의 경우 달력 속성 설정이 양력이 면 제공 된 날짜는 양력 이어야 합니다. 회교식 달력 일 경우 제공 된 날짜는 회교식 이어야 합니다.
반환 되는 날짜 부분은 현재 아랍어 달력의 기간 단위입니다. 예를 들어 현재 달력이 회교식이 고 반환 되는 날짜 부분이 연도 이면 year 값은 회교식 연도가 됩니다.
쿼리 예제
식 | 결과 |
|---|---|
|
제품 판매에서 DatePart ("yyyy", [DateofSale])를 선택 하 여 NewDate |
"DateofSale" 필드의 날짜 값에 대 한 ' Year '를 반환 합니다. |
|
제품 판매에서 DatePart ("q", [DateofSale])를 새 날짜로 선택 합니다. |
"DateofSale" 필드의 날짜 값에 대 한 ' 사분기 ' (달력 연도 기준)를 반환 합니다. |
|
제품 판매에서 DatePart ("y", [DateofSale])를 NewDate로 선택 합니다. |
"DateofSale" 필드의 날짜 값에 대 한 ' 일/월 ' (1 ~ 365)을 반환 합니다. |
|
제품 판매에서 DatePart ("d", [DateofSale])를 NewDate로 선택 합니다. |
"DateofSale" 필드의 날짜 값에 대 한 ' 일 '을 반환 합니다. |
|
제품 판매에서 DatePart ("w", [DateofSale])를 새 날짜로 선택 합니다. |
"DateofSale" 필드의 날짜 값에 대 한 ' Weekday ' (1 ~ 7의 경우 1은 일요일을 나타냄)을 반환 합니다. |
|
제품 판매에서 DatePart ("ww", [DateofSale])를 선택 하 여 NewDate |
"DateofSale" 필드의 날짜 값에 대 한 ' 주 번호 ' (1 ~ 52)를 반환 합니다. |
|
제품 판매에서 DatePart ("h", [DateTime])을 NewDate로 선택 합니다. |
"DateTime" 필드의 날짜 값에 대 한 ' a 1 '을 반환 합니다. |
|
제품 판매에서 DatePart ("n", [DateTime])을 NewDate로 선택 합니다. |
"DateTime" 필드의 날짜 값에 대 한 ' 분 '을 반환 합니다. |
|
제품 판매에서 DatePart ("s", [DateTime])을 NewDate로 선택 합니다. |
"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
