지정된 날짜의 특정 부분이 들어 있는 Variant(Integer)를 반환합니다.
|
경고 이 함수를 사용하는 데 문제가 있습니다. 일부 달력 연도의 마지막 월요일은 1주여야 하는 53주로 반환될 수 있습니다. 자세한 내용과 해결 방법은 Format 또는 DatePart 함수가 지난 월요일 연도의 잘못된 주 번호를 반환할 수 있음을 참조하세요. |
구문
DatePart ( interval, date [, firstdayofweek] [, firstweekofyear] )
DatePart 함수 구문에는 다음과 같은 인수가 사용됩니다.
|
인수 |
설명 |
|
interval |
필수 요소입니다. 반환하려는 시간 간격인 문자열 식입니다. |
|
date |
필수 요소입니다. 평가하려는 Variant(날짜) 값입니다. |
|
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가 날짜 리터럴 인 경우 지정된 연도는 해당 날짜의 영구적인 부분이 됩니다. 그러나 날짜 가 큰따옴표(" ")로 묶이고 연도를 생략하면 날짜 식이 계산될 때마다 현재 연도가 코드에 삽입됩니다. 이렇게 하면 다른 연도에 사용할 수 있는 코드를 작성할 수 있습니다.
참고: 날짜의 경우 Calendar 속성 설정이 그레고리력인 경우 제공된 날짜는 그레고리력이어야 합니다. 일정이 Hijri인 경우 제공된 날짜는 Hijri여야 합니다.
반환된 날짜 부분은 현재 아랍어 달력의 기간 단위에 있습니다. 예를 들어 현재 달력이 Hijri이고 반환할 날짜 부분이 연도인 경우 연도 값은 Hijri year입니다.
쿼리 예제
|
Expression |
결과 |
|
SELECT DatePart("yyyy",[DateofSale]) AS NewDate FROM ProductSales; |
"DateofSale" 필드의 날짜 값에 대한 'Year'를 반환합니다. |
|
SELECT DatePart("q",[DateofSale]) AS NewDate FROM ProductSales; |
"DateofSale" 필드의 날짜 값에 대한 'Quarter'(계산기 연도 기준)를 반환합니다. |
|
SELECT DatePart("y",[DateofSale]) AS NewDate FROM ProductSales; |
"DateofSale" 필드의 날짜 값에 대한 'Day of Year'(1~365)를 반환합니다. |
|
SELECT DatePart("d",[DateofSale]) AS NewDate FROM ProductSales; |
"DateofSale" 필드의 날짜 값에 대한 'Day'를 반환합니다. |
|
SELECT DatePart("w",[DateofSale]) AS NewDate FROM ProductSales; |
"DateofSale" 필드의 날짜 값에 대한 'Weekday'(1에서 7까지, 1은 일요일을 나타낸다)를 반환합니다. |
|
SELECT DatePart("ww",[DateofSale]) AS NewDate FROM ProductSales; |
"DateofSale" 필드의 날짜 값에 대한 'Week number'(1~52)를 반환합니다. |
|
SELECT DatePart("h",[DateTime]) AS NewDate FROM ProductSales; |
"DateTime" 필드의 날짜 값에 대한 'Hour'를 반환합니다. |
|
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
