# inquartertodate - 스크립트 및 차트 함수

이 함수는 timestamp가 base\_date의 마지막 밀리초까지 포함하여 base\_date를 포함한 분기의 일부에 속할 경우 True를 반환합니다.

구문:

InQuarterToDate (timestamp, base\_date, period\_no [, first\_month\_of\_year])

반환 데이터 유형: 부울

정보 메모

Qlik Sense에서 부울 true 값은 -1로 표시되고 false 값은 0으로 표시됩니다.

inquartertodate 함수의 다이어그램

inquartertodate 함수의 다이어그램

inquartertodate 함수의 다이어그램 ![inquartertodate 함수가 TRUE 값을 반환하는 날짜 범위의 다이어그램 예.](https://help.qlik.com/ko-KR/sense/May2025/Subsystems/Hub/Content/Resources/Images/scripting-functions-inquartertodate-general.png)

`inquartertodate()` 함수는 연도를 1월 1일과 12월 31일(또는 사용자 정의 연도 시작 및 해당 종료 날짜) 사이의 동일한 4분기로 나눕니다. `base_date`를 사용하면 이 함수가 특정 분기를 분할하고 `base_date`를 사용하여 해당 분기 세그먼트에 대해 허용되는 최대 날짜와 분기를 식별합니다. 마지막으로 이 함수는 지정된 날짜 값을 해당 세그먼트와 비교할 때 부울 결과를 반환합니다.

인수

| 인수 | 설명 |
| --- | --- |
| timestamp | base\_date와 비교할 날짜입니다. |
| base\_date | 분기를 평가하는 데 사용되는 날짜입니다. |
| period\_no | 분기는 period\_no로 오프셋을 지정할 수 있습니다. period\_no는 정수이며, 값 0은 base\_date를 포함하는 분기를 나타냅니다. period\_no가 음수 값일 경우 이전 분기, 양수 값일 경우 다음 분기를 나타냅니다. |
| first\_month\_of\_year | 1월에 시작되지 않는 (회계)연도를 사용하려는 경우 first\_month\_of\_year에 2와 12 사이의 값을 지정하십시오. |

## 사용 시기

`inquartertodate()` 함수는 부울 결과를 반환합니다. 일반적으로 이 유형의 함수는 `if` 표현식의 조건으로 사용됩니다. `inquartertodate()` 함수는 평가된 날짜가 해당 날짜를 포함하여 해당 날짜까지 분기에 발생했는지 여부에 따라 집계 또는 계산을 반환하는 데 사용됩니다.

예를 들어, `inquartertodate()` 함수를 사용하여 특정 날짜까지 분기에 제조된 모든 장비를 식별할 수 있습니다.

함수 예

| 예 | 결과 |
| --- | --- |
| `inquartertodate('01/25/2013', '03/25/2013', 0)` | `timestamp` 값 01/25/2013이 01/01/2013부터 03/25/2013까지의 3개월 기간 내에 있으므로 `TRUE`를 반환하고, 이 기간에는 `base_date` 값 03/25/2013이 있습니다. |
| `inquartertodate('04/26/2013', '03/25/2013', 0)` | 04/26/2013이 이전 예와 같은 기간 밖에 있으므로 `FALSE`를 반환합니다. |
| `inquartertodate('02/25/2013', '06/09/2013', -1)` | `period_no` 값 -1이 3개월(연도의 1/4) 기준의 한 기간 뒤로 검색 기간을 이동하므로 `TRUE`를 반환합니다. 이렇게 하면 검색 기간이 01/01/2013 ~ 03/09/2013이 됩니다. |
| `inquartertodate('03/25/2006', '04/15/2006', 0, 2)` | `first_month_of_year` 값이 2로 설정되어 있으므로 `TRUE`를 반환하며, 검색 기간이 04/01/2006 ~ 04/15/2006가 아닌 02/01/2006 ~ 04/15/2006이 됩니다. |

## 국가별 설정

달리 지정하지 않는 한 이 항목의 예에서는 다음 날짜 형식을 사용합니다. YYYY/MM/DD. 날짜 형식은 데이터 로드 스크립트의 `SET DateFormat` 문에 지정됩니다. 기본 날짜 형식은 지역 설정 및 기타 요인으로 인해 시스템에서 다를 수 있습니다. 아래 예의 형식을 요구 사항에 맞게 변경할 수 있습니다. 또는 이러한 예와 일치하도록 로드 스크립트의 형식을 변경할 수 있습니다.

앱의 기본 국가별 설정은 Qlik Sense가 설치된 컴퓨터 또는 서버의 국가별 시스템 설정을 기반으로 합니다. 액세스하는 Qlik Sense 서버가 스웨덴으로 설정된 경우 데이터 로드 편집기는 날짜, 시간 및 통화에 대해 스웨덴 지역 설정을 사용합니다. 이러한 국가별 형식 설정은 Qlik Sense 사용자 인터페이스에 표시되는 언어와 관련이 없습니다. Qlik Sense는 사용 중인 브라우저와 동일한 언어로 표시됩니다.

## 예 1 – 추가 인수 없음

[](https://help.qlik.com/en-US/sense/Subsystems/Hub/Content/Sense_Hub/Scripting/DateAndTimeFunctions/inquartertodate.htm)

#### 로드 스크립트 및 결과

개요

데이터 로드 편집기를 열고 새 섹션에 아래 로드 스크립트를 추가합니다.

로드 스크립트에는 다음이 포함됩니다.

* `Transactions`라는 테이블에 로드되는 2022년 트랜잭션 집합이 포함된 데이터 집합.

* `DateFormat` 시스템 변수(MM/DD/YYYY) 서식으로 제공된 날짜 필드.

* 2022년 5월 15일까지 분기에 발생한 트랜잭션을 결정하는 필드 `  in_quarter_to_date ` 만들기.

로드 스크립트

```
SET DateFormat='MM/DD/YYYY';
						
Transactions:
    Load
        *,
        inquartertodate(date,'05/15/2022', 0) as in_quarter_to_date
        ;
Load
*
Inline
[
id,date,amount
8188,'1/19/2022',37.23
8189,'1/7/2022',17.17
8190,'2/28/2022',88.27
8191,'2/5/2022',57.42
8192,'3/16/2022',53.80
8193,'4/1/2022',82.06
8194,'5/7/2022',40.39
8195,'5/16/2022',87.21
8196,'6/15/2022',95.93
8197,'6/26/2022',45.89
8198,'7/9/2022',36.23
8199,'7/22/2022',25.66
8200,'7/23/2022',82.77
8201,'7/27/2022',69.98
8202,'8/2/2022',76.11
8203,'8/8/2022',25.12
8204,'8/19/2022',46.23
8205,'9/26/2022',84.21
8206,'10/14/2022',96.24
8207,'10/29/2022',67.67
];
```

결과

데이터를 로드하고 시트를 엽니다. 새 테이블을 만들고 다음 필드를 차원으로 추가합니다.

* `date`

* `in_quarter_to_date`

결과 테이블

| 날짜 | in\_quarter\_to\_date |
| --- | --- |
| 1/7/2022 | 0 |
| 1/19/2022 | 0 |
| 2/5/2022 | 0 |
| 2/28/2022 | 0 |
| 3/16/2022 | 0 |
| 4/1/2022 | -1 |
| 5/7/2022 | -1 |
| 5/16/2022 | 0 |
| 6/15/2022 | 0 |
| 6/26/2022 | 0 |
| 7/9/2022 | 0 |
| 7/22/2022 | 0 |
| 7/23/2022 | 0 |
| 7/27/2022 | 0 |
| 8/2/2022 | 0 |
| 8/8/2022 | 0 |
| 8/19/2022 | 0 |
| 9/26/2022 | 0 |
| 10/14/2022 | 0 |
| 10/29/2022 | 0 |

'`in_quarter_to_date`' 필드는 `inquartertodate()` 함수를 사용하여 선행 LOAD 문에서 만들어집니다. 제공된 첫 번째 인수는 평가 중인 필드를 식별합니다. 두 번째 인수는 5월 15일에 대한 하드 코딩된 날짜이며, 세그먼트로 분할할 분기를 식별하고 해당 세그먼트의 끝 경계를 정의하는 `base_date`입니다. `period_no` 0은 마지막 인수이며, 이는 함수가 세그먼트로 분할된 분기 앞이나 뒤에 있는 분기를 비교하지 않음을 의미합니다.

inquartertodate 함수의 다이어그램, 추가 인수 없음

inquartertodate 함수의 다이어그램, 추가 인수 없음

inquartertodate 함수의 다이어그램, 추가 인수 없음![inquartertodate 함수가 TRUE 값을 반환하는 날짜 범위를 보여 주는 다이어그램.](https://help.qlik.com/ko-KR/sense/May2025/Subsystems/Hub/Content/Resources/Images/scripting-functions-inquartertodate-example-no-additional-arguments.png)

4월 1일과 5월 15일 사이에 발생하는 모든 트랜잭션은 부울 결과 `TRUE`를 반환합니다. 5월 16일 이후의 트랜잭션 날짜는 4월 1일 이전의 트랜잭션과 마찬가지로 `FALSE`를 반환됩니다.

## 예 2 – period\_no

[](https://help.qlik.com/en-US/sense/Subsystems/Hub/Content/Sense_Hub/Scripting/DateAndTimeFunctions/inquartertodate.htm)

#### 로드 스크립트 및 결과

개요

데이터 로드 편집기를 열고 새 섹션에 아래 로드 스크립트를 추가합니다.

로드 스크립트에는 다음이 포함됩니다.

* 첫 번째 예와 동일한 데이터 집합 및 시나리오.

* 2022년 5월 15일에 끝나는 분기 세그먼트 이전의 전체 분기에 발생하는 트랜잭션을 결정하는 필드 `previous_qtr_to_date` 만들기.

로드 스크립트

```
SET DateFormat='MM/DD/YYYY';

Transactions:
    Load
        *,
        inquartertodate(date,'05/15/2022', -1) as previous_qtr_to_date
        ;
Load
*
Inline
[
id,date,amount
8188,'1/19/2022',37.23
8189,'1/7/2022',17.17
8190,'2/28/2022',88.27
8191,'2/5/2022',57.42
8192,'3/16/2022',53.80
8193,'4/1/2022',82.06
8194,'5/7/2022',40.39
8195,'5/16/2022',87.21
8196,'6/15/2022',95.93
8197,'6/26/2022',45.89
8198,'7/9/2022',36.23
8199,'7/22/2022',25.66
8200,'7/23/2022',82.77
8201,'7/27/2022',69.98
8202,'8/2/2022',76.11
8203,'8/8/2022',25.12
8204,'8/19/2022',46.23
8205,'9/26/2022',84.21
8206,'10/14/2022',96.24
8207,'10/29/2022',67.67
];
```

결과

데이터를 로드하고 시트를 엽니다. 새 테이블을 만들고 다음 필드를 차원으로 추가합니다.

* `date`

* `previous_qtr_to_date`

결과 테이블

| 날짜 | previous\_qtr\_to\_date |
| --- | --- |
| 1/7/2022 | -1 |
| 1/19/2022 | -1 |
| 2/5/2022 | -1 |
| 2/28/2022 | 0 |
| 3/16/2022 | 0 |
| 4/1/2022 | 0 |
| 5/7/2022 | 0 |
| 5/16/2022 | 0 |
| 6/15/2022 | 0 |
| 6/26/2022 | 0 |
| 7/9/2022 | 0 |
| 7/22/2022 | 0 |
| 7/23/2022 | 0 |
| 7/27/2022 | 0 |
| 8/2/2022 | 0 |
| 8/8/2022 | 0 |
| 8/19/2022 | 0 |
| 9/26/2022 | 0 |
| 10/14/2022 | 0 |
| 10/29/2022 | 0 |

`period_no` 값 -1은 `inquartertodate ()` 함수가 입력 분기 세그먼트를 이전 분기와 비교함을 나타냅니다. 5월 15일은 올해의 2분기에 속하므로 이 세그먼트는 처음에 4월 1일과 5월 15일 사이에 해당합니다. 그런 다음 `period_no`는 이 세그먼트를 3개월 앞서 오프셋하여 날짜 경계가 1월 1일에서 2월 15일이 되도록 합니다.

inquartertodate 함수의 다이어그램, period\_no 예

inquartertodate 함수의 다이어그램, period\_no 예

inquartertodate 함수의 다이어그램, period\_no 예![inquartertodate 함수가 TRUE 값을 반환하는 날짜 범위를 보여 주는 다이어그램.](https://help.qlik.com/ko-KR/sense/May2025/Subsystems/Hub/Content/Resources/Images/scripting-functions-inquartertodate-example-period-no.png)

따라서 1월 1일과 2월 15일 사이에 발생하는 모든 트랜잭션은 부울 결과 `TRUE`를 반환합니다.

## 예 3 – first\_month\_of\_year

[](https://help.qlik.com/en-US/sense/Subsystems/Hub/Content/Sense_Hub/Scripting/DateAndTimeFunctions/inquartertodate.htm)

#### 로드 스크립트 및 결과

개요

데이터 로드 편집기를 열고 새 섹션에 아래 로드 스크립트를 추가합니다.

로드 스크립트에는 다음이 포함됩니다.

* 첫 번째 예와 동일한 데이터 집합 및 시나리오.

* 2022년 5월 15일까지 같은 분기에 발생한 트랜잭션을 결정하는 필드 `in_quarter_to_date` 만들기.

이 예에서는 3월을 회계 연도의 첫 번째 달로 설정합니다.

로드 스크립트

```
SET DateFormat='MM/DD/YYYY';

Transactions:
    Load
        *,
        inquartertodate(date,'05/15/2022', 0,3) as in_quarter_to_date
        ;
Load
*
Inline
[
id,date,amount
8188,'1/19/2022',37.23
8189,'1/7/2022',17.17
8190,'2/28/2022',88.27
8191,'2/5/2022',57.42
8192,'3/16/2022',53.80
8193,'4/1/2022',82.06
8194,'5/7/2022',40.39
8195,'5/16/2022',87.21
8196,'6/15/2022',95.93
8197,'6/26/2022',45.89
8198,'7/9/2022',36.23
8199,'7/22/2022',25.66
8200,'7/23/2022',82.77
8201,'7/27/2022',69.98
8202,'8/2/2022',76.11
8203,'8/8/2022',25.12
8204,'8/19/2022',46.23
8205,'9/26/2022',84.21
8206,'10/14/2022',96.24
8207,'10/29/2022',67.67
];
```

결과

데이터를 로드하고 시트를 엽니다. 새 테이블을 만들고 다음 필드를 차원으로 추가합니다.

* `date`

* `in_quarter_to_date`

결과 테이블

| 날짜 | in\_quarter\_to\_date |
| --- | --- |
| 1/7/2022 | 0 |
| 1/19/2022 | 0 |
| 2/5/2022 | 0 |
| 2/28/2022 | 0 |
| 3/16/2022 | -1 |
| 4/1/2022 | -1 |
| 5/7/2022 | -1 |
| 5/16/2022 | 0 |
| 6/15/2022 | 0 |
| 6/26/2022 | 0 |
| 7/9/2022 | 0 |
| 7/22/2022 | 0 |
| 7/23/2022 | 0 |
| 7/27/2022 | 0 |
| 8/2/2022 | 0 |
| 8/8/2022 | 0 |
| 8/19/2022 | 0 |
| 9/26/2022 | 0 |
| 10/14/2022 | 0 |
| 10/29/2022 | 0 |

`inquartertodate()` 함수에서 3을 `first_month_of_year` 인수로 사용하면 이 함수는 3월 1일에 연도를 시작한 다음 연도를 분기로 나눕니다. 따라서 분기 세그먼트는 다음과 같습니다.

* 3월~5월

* 6월~8월

* 9월~11월

* 12월~2월

그런 다음 `base_date`가 5월 15일이면 끝 경계가 5월 15일로 설정되어 3월에서 5월까지 분기가 세그먼트로 분할됩니다.

inquartertodate 함수의 다이어그램, first\_month\_of\_year 예

inquartertodate 함수의 다이어그램, first\_month\_of\_year 예

inquartertodate 함수의 다이어그램, first\_month\_of\_year 예![inquartertodate 함수가 TRUE 값을 반환하는 날짜 범위를 보여 주는 다이어그램.](https://help.qlik.com/ko-KR/sense/May2025/Subsystems/Hub/Content/Resources/Images/scripting-functions-inquartertodate-example-first-mth-yr.png)

따라서 3월 1일에서 5월 15일 사이에 발생하는 모든 트랜잭션은 부울 결과 `TRUE`를 반환하는 반면 날짜가 이 경계를 벗어난 트랜잭션은 `FALSE` 값을 반환합니다.

## 예 4 – 차트 개체 예

[](https://help.qlik.com/en-US/sense/Subsystems/Hub/Content/Sense_Hub/Scripting/DateAndTimeFunctions/inquartertodate.htm)

#### 로드 스크립트 및 차트 표현식

개요

데이터 로드 편집기를 열고 아래의 로드 스크립트를 새 탭에 추가합니다.

이 로드 스크립트에는 첫 번째 예와 동일한 데이터 집합 및 시나리오가 포함되어 있습니다. 그러나 이 예에서는 변경되지 않은 데이터 집합이 응용 프로그램에 로드됩니다. 5월 15일과 같은 분기에 발생한 트랜잭션을 결정하는 계산이 차트 개체의 측정값으로 만들어집니다.

로드 스크립트

```
SET DateFormat='MM/DD/YYYY';

Transactions:
Load
*
Inline
[
id,date,amount
8188,'1/19/2022',37.23
8189,'1/7/2022',17.17
8190,'2/28/2022',88.27
8191,'2/5/2022',57.42
8192,'3/16/2022',53.80
8193,'4/1/2022',82.06
8194,'5/7/2022',40.39
8195,'5/16/2022',87.21
8196,'6/15/2022',95.93
8197,'6/26/2022',45.89
8198,'7/9/2022',36.23
8199,'7/22/2022',25.66
8200,'7/23/2022',82.77
8201,'7/27/2022',69.98
8202,'8/2/2022',76.11
8203,'8/8/2022',25.12
8204,'8/19/2022',46.23
8205,'9/26/2022',84.21
8206,'10/14/2022',96.24
8207,'10/29/2022',67.67
];
```

결과

데이터를 로드하고 시트를 엽니다. 새 테이블을 만들고 이 필드를 차원으로 추가합니다.date.

다음 측정값을 만듭니다.

=inquartertodate(date,'05/15/2022', 0)

결과 테이블

| 날짜 | =inquartertodate(date,'05/15/2022', 0) |
| --- | --- |
| 1/7/2022 | 0 |
| 1/19/2022 | 0 |
| 2/5/2022 | 0 |
| 2/28/2022 | 0 |
| 3/16/2022 | 0 |
| 4/1/2022 | -1 |
| 5/7/2022 | -1 |
| 5/16/2022 | 0 |
| 6/15/2022 | 0 |
| 6/26/2022 | 0 |
| 7/9/2022 | 0 |
| 7/22/2022 | 0 |
| 7/23/2022 | 0 |
| 7/27/2022 | 0 |
| 8/2/2022 | 0 |
| 8/8/2022 | 0 |
| 8/19/2022 | 0 |
| 9/26/2022 | 0 |
| 10/14/2022 | 0 |
| 10/29/2022 | 0 |

in\_quarter\_to\_date 측정값은 inquartertodate() 함수를 사용하여 차트 개체에 만들어집니다. 첫 번째 인수는 평가되는 날짜 필드입니다. 두 번째 인수는 5월 15일에 대한 하드 코딩된 날짜이며, 세그먼트로 분할할 분기를 식별하고 해당 세그먼트의 끝 경계를 정의하는 base\_date입니다. period\_no 0은 마지막 인수이며, 이는 함수가 세그먼트로 분할된 분기 앞이나 뒤에 있는 분기를 비교하지 않음을 의미합니다.

inquartertodate 함수 다이어그램, 차트 개체 예

inquartertodate 함수 다이어그램, 차트 개체 예

inquartertodate 함수 다이어그램, 차트 개체 예![inquartertodate 함수가 TRUE 값을 반환하는 날짜 범위를 보여 주는 다이어그램.](https://help.qlik.com/ko-KR/sense/May2025/Subsystems/Hub/Content/Resources/Images/scripting-functions-inquartertodate-example-chart-object.png)

4월 1일과 5월 15일 사이에 발생하는 모든 트랜잭션은 부울 결과 TRUE를 반환합니다. 5월 16일 이후의 트랜잭션은 4월 1일 이전의 트랜잭션과 마찬가지로 FALSE를 반환됩니다.

## 예 5 – 시나리오

[](https://help.qlik.com/en-US/sense/Subsystems/Hub/Content/Sense_Hub/Scripting/DateAndTimeFunctions/inquartertodate.htm)

#### 로드 스크립트 및 차트 표현식

개요

데이터 로드 편집기를 열고 새 섹션에 아래 로드 스크립트를 추가합니다.

로드 스크립트에는 다음이 포함됩니다.

* Products라는 테이블에 로드되는 데이터 집합.

* 제품 ID, 제조 날짜 및 원가에 관한 정보.

2022년 5월 15일, 제조 과정에서 일부 장비 오류가 발견되어 해결되었습니다. 이 날짜까지 해당 분기에 제조된 제품은 결함이 있습니다. 최종 사용자는 제품이 '결함' 또는 '무결함'인 상태와 해당 분기에서 현재까지 제조된 제품의 비용을 분기 이름별로 표시하는 차트 개체를 원합니다.

로드 스크립트

```
Products:
Load
*
Inline 
[
product_id,manufacture_date,cost_price
8188,'1/19/2022',37.23
8189,'1/7/2022',17.17
8190,'2/28/2022',88.27
8191,'2/5/2022',57.42
8192,'3/16/2022',53.80
8193,'4/1/2022',82.06
8194,'5/7/2022',40.39
8195,'5/16/2022',87.21
8196,'6/15/2022',95.93
8197,'6/26/2022',45.89
8198,'7/9/2022',36.23
8199,'7/22/2022',25.66
8200,'7/23/2022',82.77
8201,'7/27/2022',69.98
8202,'8/2/2022',76.11
8203,'8/8/2022',25.12
8204,'8/19/2022',46.23
8205,'9/26/2022',84.21
8206,'10/14/2022',96.24
8207,'10/29/2022',67.67
];
```

결과

다음과 같이 하십시오.

1. 데이터를 로드하고 시트를 엽니다. 새 테이블을 만듭니다. 분기 이름을 표시할 차원을 만듭니다.

   =quartername(manufacture\_date)

2. 다음으로 결함이 있는 제품과 무결함인 제품을 식별하는 차원을 만듭니다.

   =if(inquartertodate(manufacture\_date,makedate(2022,05,15),0),'Defective','Faultless')

3. 제품의 cost\_price 합계를 계산하는 측정값을 만듭니다.

   =sum(cost\_price)

4. 측정값의 숫자 형식을 화폐로 설정합니다.

결과 테이블

| quartername(manufacture\_date) | if(inquartertodate(manufacture\_date,makedate(2022,05,15),0),'Defective','Faultless') | Sum(cost\_price) |
| --- | --- | --- |
| Jan-Mar 2022 | 무결함 | $253.89 |
| Apr-Jun 2022 | 무결함 | $229.03 |
| Apr-Jun 2022 | 결함 | $122.45 |
| Jul-Sep 2022 | 무결함 | $446.31 |
| Oct-Dec 2022 | 무결함 | $163.91 |

inquartertodate() 함수는 각 제품의 제조 날짜를 평가할 때 부울 값을 반환합니다. 부울 값 TRUE를 반환하는 경우 제품을 ‘Defective’로 표시합니다. FALSE 값을 반환하므로 5월 15일을 포함하는 분기까지 제조되지 않은 제품의 경우 제품을 ‘Faultless’로 표시합니다.