# CALCULATE

## Content

이 함수는 TableSheet의 그룹 수준에서 요약할 때 그룹 컨텍스트를 확장하는 데 사용할 수 있습니다. 이 함수는 첫 번째 인수로 표현된 수식의 컨텍스트를 확장합니다.

## 구문

`=CALCULATE (formula_string, expand_context)`

## 인수

이 함수는 다음 인수를 가집니다:

| 인수                | 설명                                            |
| ----------------- | --------------------------------------------- |
| *formula\_string* | \[필수] expand\_context의 컨텍스트로 평가되는 수식입니다.      |
| *expand\_context* | \[필수] expand\_context는 REMOVEFILTERS에서 가져옵니다. |

## 설명

CALCULATE 함수는 groupBy 메서드의 `summaryFields` 옵션 내 `formula` 속성에서만 사용해야 합니다.

## 데이터 유형

숫자 값을 입력으로 받고, 숫자 값을 반환합니다.

## 예제

다음 샘플 코드는 CALCULATE 함수의 기본 사용법을 보여줍니다.

```JavaScript
sheet.groupBy([
    {
        caption: "Ship Via", field: `ShipVia`, width: 160,
        summaryFields: [
            {
                caption: "Ratio of Year Quarter", width: 170, style: { formatter: "0.00%" },
                formula: `=SUM([Freight]) / CALCULATE( SUM([Freight]), REMOVEFILTERS("ShipVia"))`, // 화물 레벨에서의 합계와 선적명 레벨에서의 합계 비율
            }
        ]
    }
])
```