式¶

演算子¶

このグループには演算子が含まれています（例えば、+、 - 、*）。以下の数学関数のほとんどについて、入力の一つが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" LIKE 'Hello%'

Conditionals¶

このグループには式の中で条件を扱う関数を含まれます.

いくつかの例：

• 最初の条件がtrueである場合は値を戻し、そうでない場合は別の値を:

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

数学関数¶

このグループは、数学関数（例えば、平方根、sinとcos）が含まれています。

集計関数¶

このグループには、レイヤーやフィールドの値を集約する関数が含まれています。

例:

• 「station_class」フィールドでグループ化されたレイヤー中の地物から「乗客」フィールドの最大値を返します:

  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")

色関数¶

このグループには、色を操作するための関数が含まれています。

変換関数¶

このグループは、別の（整数にする例えば、文字列、文字列の整数）に1つのデータ型を変換する関数が含まれています。

カスタム関数¶

このグループは、ユーザーが作成した関数が含まれています。詳細については 関数エディタ を参照。

日付と時刻の関数¶

このグループには日付や時刻データを扱う関数が含まれます.

このグループはまた、 変換関数 （TO_DATE、TO_TIME、to_datetime、to_interval）と 文字列関数 （format_date）グループといくつかの関数を共有します。

いくつかの例：

• 「month_number /年」の形式で、今日の月と年を取得します。

  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¶

このグループにはレコードを特定するような関数が含まれます.

いくつかの例：

• フィールド「ID」が現在の地物のフィールド「名前」と同じ値を有するレイヤー「LayerA」の最初の地物を返します（jointureの一種）:

  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.

変数関数¶

このグループには、アプリケーション、プロジェクトファイルやその他の設定に関連した動的変数が含まれています。これは、一部の関数は文脈に応じて使用できない場合があることを意味します。

• ^式で選択 ダイアログから

• ^{フィールド計算機} ダイアログから

• レイヤーのプロパティダイアログから

• from the print composer

式の中でこれらの関数を使用するには、それらの前に@文字を付けなければなりません（例えば、@row_number）。懸念しています：