표현식¶

연산자¶

이 그룹은 +, -, * 같은 연산자를 담고 있습니다. 다음에 설명하는 수학 함수들 대부분이, 입력 값 가운데 하나가 NULL인 경우 NULL을 반환한다는 점을 유념하십시오.

다음은 몇몇 예시입니다:

• 문자열과 열 명칭의 값을 연결합니다:

  'My feature''s id is: ' || "gid"
  'My feature''s id is: ' + "gid" => triggers an error as gid is an integer
  "country_name" + '(' + "country_code" + ')'
  "country_name" || '(' || "country_code" || ')'

• “description” 속성 필드의 값이 ‘Hello’ 문자열로 시작하는지 검증합니다(% 문자의 위치를 주목하세요):

  "description" LIKE 'Hello%'

Conditionals¶

이 그룹은 표현식에서 조건 검사를 처리하는 함수를 담고 있습니다.

다음은 예시입니다:

• 첫 번째 조건이 참인 경우 값을 회신하고, 아닌 경우 다른 값을 회신합니다:

  CASE WHEN "software" LIKE '%QGIS%' THEN 'QGIS' ELSE 'Other' END

수학 함수¶

이 그룹은 제곱근, 삼각함수 등의 수학 함수를 담고 있습니다.

집계 함수¶

이 그룹은 레이어 및 필드에 있는 값들을 집계하는 함수를 담고 있습니다.

다음은 몇몇 예시입니다:

• “station_class” 필드로 그룹화된 레이어에 있는 피처에서 “passengers” 필드의 최대값을 반환합니다:

  maximum("passengers", group_by:="station_class")

• 현재 지도 피처 안에 있는 역에 대해 총 승객 명수를 계산합니다:

  aggregate('rail_stations','sum',"passengers",
    intersects(@atlas_geometry, $geometry))

• 레이어에서 ‘my_relation’ 관계를 사용해서 일치하는 모든 파생 피처에 대해 “field_from_related_table” 필드의 평균값을 반환합니다:

  aggregate_relation('my_relation', 'mean', "field_from_related_table")
  

  또는 이렇게 작성할 수도 있습니다:

  aggregate_relation(relation:='my_relation', calculation := 'mean',
    expression := "field_from_related_table")

색상 함수¶

이 그룹은 색상을 처리하기 위한 함수를 담고 있습니다.

변환 함수¶

이 그룹은 어느 데이터 유형을 다른 데이터 유형으로 변환하는 함수를 담고 있습니다. (예: 문자열을 정수형으로, 정수형을 문자열로)

사용자 지정 함수¶

이 그룹은 사용자가 생성한 함수를 담고 있습니다. 자세한 내용은 함수 편집기 를 참조하세요.

날짜 및 시간 함수¶

이 그룹은 날짜 및 시간 데이터를 처리하기 위한 함수를 담고 있습니다.

이 그룹은 변환 함수 그룹과 몇몇 함수를( to_date, to_time, to_datetime, to_interval) 그리고 ref:string_functions 그룹과도 함수를(format_date) 공유하고 있습니다.

다음은 몇몇 예시입니다:

• “month_number/year” 서식으로 오늘의 월 및 연도를 얻으려면:

  format_date(now(),'MM/yyyy')
  -- Returns '03/2017'
  

이런 함수들 외에도, - (빼기) 연산자를 통해 날짜, 날짜&시간 또는 시간 유형을 뺄셈하면 간격 유형을 반환할 것입니다.

+ (더하기) 또는 - (빼기) 연산자를 이용해서 날짜, 날짜&시간 또는 시간 유형에 간격 유형을 더하거나 빼면 날짜&시간 유형을 반환합니다.

• QGIS 3.0 배포일까지 며칠 남았는지 알아보려면:

  to_date('2017-09-29') - to_date(now())
  -- Returns <interval: 203 days>
  

• 같은 내용을 시간 유형으로:

  to_datetime('2017-09-29 12:00:00') - to_datetime(now())
  -- Returns <interval: 202.49 days>
  

• 현재부터 100일 후의 날짜&시간을 얻으려면:

  now() + to_interval('100 days')
  -- Returns <datetime: 2017-06-18 01:00:00>
  

필드 및 값¶

이 그룹은 레이어에 있는 필드의 목록을 담고 있습니다.

Generally, you can use the various fields, values and functions to construct the calculation expression, or you can just type it into the box.

To display the values of a field, you just click on the appropriate field and choose between Load top 10 unique values and Load all unique values. On the right side, the Field Values list opens with the unique values. At the top of the list, a search box helps filtering the values. To add a value to the expression you are writing, double click its name in the list.

Sample values can also be accessed via right-click. Select the field name from the list, then right-click to access a context menu with options to load sample values from the selected field.

Fields name should be double-quoted in the expression. Values or string should be simple-quoted.

퍼지 매칭 함수¶

이 그룹은 값들을 퍼지 비교하기 위한 함수를 담고 있습니다.

일반 함수¶

이 그룹은 일반으로 분류된 함수를 담고 있습니다.

도형 함수¶

이 그룹은 도형 객체를 대상으로 하는 (예: 길이, 면적 등) 함수를 담고 있습니다.

다음은 몇몇 예시입니다:

• $geometry 변수로 현재 도형에 버퍼를 생성하거나 표면 상에 있는 포인트를 얻을 수 있습니다:

  buffer( $geometry, 10 )
  point_on_surface( $geometry )

• Return the x coordinate of the current feature’s centroid:

  x( $geometry )

• 피처의 면적에 따라 값을 회신합니다:

  CASE WHEN $area > 10 000 THEN 'Larger' ELSE 'Smaller' END

Record Functions¶

이 그룹은 레코드 식별자를 대상으로 하는 함수를 담고 있습니다.

다음은 몇몇 예시입니다:

• “LayerA” 레이어에서 “id” 필드가 현재 피처의 “name” 필드와 동일한 값을 지닌 첫 번째 피처를 반환합니다(필드 결합의 일종입니다):

  get_feature( 'layerA', 'id', attribute( $currentfeature, 'name') )

• 이전 예시에서 결합된 피처의 면적을 계산합니다:

  area( geometry( get_feature( 'layerA', 'id', attribute( $currentfeature, 'name') ) ) )

문자열 함수¶

이 그룹은 문자열을 대상으로 하는 (예: 치환, 대문자 변환 등) 함수를 담고 있습니다.

최근 함수¶

This group contains recently used functions. Any expression used in the Expression dialog is added to the list, sorted from the more recent to the less one. This helps to quickly retrieve any previous expression.

변수 함수¶

이 그룹은 응용 프로그램, 프로젝트 파일 및 기타 설정과 관련된 동적 변수를 담고 있습니다. 즉 다음 맥락에 따라 일부 함수를 사용하지 못 할 수도 있다는 뜻입니다:

• ^{Select by expression} 대화창에서

• ^{Field calculator} 대화창에서

• 레이어 속성 대화창에서

• from the print composer

표현식에 다음 함수들을 사용하려면, 앞에 @ 문자를 (예: @row_number) 붙여야 합니다: