# DATEPART

## Content

이 함수는 지정된 연도, 월, 일 정보를 기반으로 날짜(Date) 객체를 반환합니다.

## 구문

`DATEPART ( date_value, format_string, [week_num_type] )`

## 인수

| 인수 | 설명 |
| --- | --- |
| *date\_value* | (필수) 날짜 값입니다. |
| *format\_string* | (필수) 날짜 형식 문자열입니다. |
| *[week\_num\_type]* | (선택) WEEKNUM 함수의 두 번째 인수와 동일한 역할을 합니다. |

## 설명

이 함수는 필드를 그룹화할 때 사용할 수 있습니다.
다음 표는 DATEPART 수식에 사용할 수 있는 다양한 형식 문자열을 보여줍니다:

| 형식 | 결과 | 설명 |
| --- | --- | --- |
| yyyQ | 20214 | 숫자: 1자리 (분기 번호/이름) |
| yyyQQ | 202104 | 숫자: 2자리 + 0으로 채움 |
| yyyyQQQ | 2021Q4 | 축약형 |
| yyyy QQQQ | 2021 4th quarter | 전체 서술형 |
| YYYY w | 2021 8 | 숫자: 최소 자릿수, 연도의 주차 (숫자)<br>형식 문자열에서 연도와 함께 사용할 경우 'Y'를 사용 |
| YYYY ww | 2021 08 | 숫자: 2자리, 필요 시 0으로 채움 |
| MM-yyyy | 09-2021 | 셀 서식에서 부분 날짜 포맷터 제공 |

## 데이터 형식

문자열 데이터를 입력받으며, 날짜(Date) 객체를 반환합니다.

## 예제

다음은 DATEPART 함수의 기본 사용 예입니다.

```javascript
sheet.groupBy([
    {
        caption: "Company Name", field: "Customers.CompanyName", width: 160,
    },
    {
        caption: "Year Quarter", field: `=DATEPART([@OrderDate],"yyyyQQQ")`, width: 160,
    }
]);
```