# Declare

Declare 문은 필드 또는 함수 간의 관계를 정의할 수 있는 필드 정의를 만드는 데 사용됩니다. 일련의 필드 정의는 차원으로 사용할 수 있는 파생된 필드를 자동으로 생성하는 데 사용할 수 있습니다. 예를 들어, 캘린더 정의를 만들 수 있으며 이를 사용하여 날짜 필드에서 연도, 월, 주, 일 등의 관련 차원을 생성할 수 있습니다.

Declare는 새 필드 정의를 설정하거나 기존 정의에 기반하여 필드 정의를 만들 때 사용할 수 있습니다.

## 새 필드 정의 설정

구문:

definition\_name:

Declare [Field[s]] Definition [Tagged tag\_list ]

[Parameters parameter\_list ]

Fields field\_list

인수:

| 인수 | 설명 |
| --- | --- |
| definition\_name | 필드 정의의 이름이며 콜론으로 끝납니다.<br><br>경고 메모필드 정의에 대한 이름으로 autoCalendar를 사용하지 마십시오. 이 이름은 자동 생성 캘린더 템플릿용으로 예약되어 있습니다.<br><br>`Calendar:` |
| tag\_list | 필드 정의에서 파생된 필드에 적용할 태그의 쉼표로 구분된 목록입니다. 태그 적용은 선택 사항이지만, $date, $numeric 또는 $text 등과 같이 정렬 순서를 지정하는 데 사용되는 태그를 적용하지 않으면 파생 필드가 기본적으로 로드 순서에 따라 정렬됩니다.<br><br>`'$date'Thank you for bringing this to our attention, and apologies for the inconvenience.`<br><br>[필드 태그](https://help.qlik.com/ko-KR/sense/November2025/Subsystems/Hub/Content/Sense_Hub/Scripting/field-tags.htm) |
| parameter\_list | 쉼표로 구분된 매개 변수 목록입니다. 매개 변수는 `name=value` 형식으로 정의되며 필드 정의를 재사용할 때 재정의할 수 있는 시작 값이 할당됩니다. 선택 사항입니다.<br><br>`first_month_of_year = 1` |
| field\_list | 필드 정의를 사용할 때 생성되는 쉼표로 구분된 필드 목록입니다. 필드는 `<expression> As field_name tagged tag` 형식으로 정의됩니다. `$1`을 사용하여, 파생 필드를 생성해야 하는 원본 데이터 필드를 참조합니다.<br><br>`Year($1) As Year tagged ('$numeric')` |

```
Calendar:
DECLARE FIELD DEFINITION TAGGED '$date'
   Parameters
      first_month_of_year = 1
   Fields      
```

```
      Year($1) As Year Tagged ('$numeric'),
      Month($1) as Month Tagged ('$numeric'),
      Date($1) as Date Tagged ('$date'),
      Week($1) as Week Tagged ('$numeric'),
      Weekday($1) as Weekday Tagged ('$numeric'),
      DayNumberOfYear($1, first_month_of_year) as DayNumberOfYear Tagged ('$numeric')
;
```

```
 
```

이제 캘린더가 정의되고, 이를 Derive 절을 사용하여 로드된 데이터 필드(이 경우에는 OrderDate 및 ShippingDate)에 적용할 수 있습니다.

[파생 필드](https://help.qlik.com/ko-KR/sense/November2025/Subsystems/Hub/Content/Sense_Hub/Scripting/derived-fields.htm) (전체 예)

## 기존 필드 정의 재사용

구문:

&lt;definition name&gt;:

Declare [Field][s] Definition

Using &lt;existing\_definition&gt;

[With &lt;parameter\_assignment&gt; ]

인수:

| 인수 | 설명 |
| --- | --- |
| definition\_name | 필드 정의의 이름이며 콜론으로 끝납니다.<br><br>MyCalendar: |
| existing\_definition | 새 필드 정의를 만들 때 재사용할 필드 정의입니다. 새로운 필드 정의는, parameter\_assignment를 사용하여 필드 표현식에 사용된 값을 변경하는 경우를 제외하고, 해당 정의의 기반으로 사용된 원본 정의와 동일한 방식으로 작동합니다.<br><br>Using Calendar |
| parameter\_assignment | 쉼표로 구분된 매개 변수 할당 목록입니다. 매개 변수 할당은 name=value 형식으로 정의되며, 기본 필드 정의에 설정된 매개 변수 값을 재정의합니다. 선택 사항입니다.<br><br>first\_month\_of\_year = 4 |

이 예에서는 이전 예에서 만든 캘린더 정의를 재사용합니다. 이 사례의 경우 4월에 시작하는 회계년도를 사용하려고 합니다. 이 작업은 값 4를 first\_month\_of\_year 매개 변수에 할당하여 수행되며, 정의된 DayNumberOfYear 필드에 영향을 미칠 수 있습니다.

이 예에서는 이전 예의 샘플 데이터와 필드 정의를 사용한다고 가정합니다.

MyCalendar: DECLARE FIELD DEFINITION USING Calendar WITH first\_month\_of\_year=4;

DERIVE FIELDS FROM FIELDS OrderDate,ShippingDate USING MyCalendar;

데이터 스크립트를 다시 로드하면 OrderDate.MyCalendar.\* 및 ShippingDate.MyCalendar.\*라는 이름으로 생성된 필드를 시트 편집기에서 사용할 수 있습니다.

## 자세한 정보

* [Derive](https://help.qlik.com/ko-KR/sense/November2025/Subsystems/Hub/Content/Sense_Hub/Scripting/ScriptRegularStatements/Derive.htm)