Expressions documentation single page (locale ja)

別のレイヤの地物を使って計算された値の集計値を返します。

属性値を集約し、配列として返します。

式で集約されたジオメトリをマルチパートジオメトリとして返します。

属性または式の値を、区切り文字（デリミタ）で連結した文字列を返します。

属性または式の重複のない値を、区切り文字（デリミタ）で連結した文字列で返します。

マッチする地物の数を返します。

重複を除いた（distinctな）値の数を返します。

欠損値（null）の数を返します。

フィールドまたは式の値の四分位範囲（IQR）を返します。

フィールドまたは式の最頻値を返します。

フィールドまたは式の文字列の最大長を返します。

フィールドまたは式の最大値を返します。

フィールドまたは式の平均値を返します。

フィールドまたは式の中央値を返します。

フィールドまたは式の文字列の最短長を返します。

フィールドまたは式の最小値を返します。

フィールドまたは式の最少出現値を返します。

フィールドまたは式の値の第１四分位数を返します。

フィールドまたは式の値の第３四分位数を返します。

フィールドまたは式の値の範囲（最大値 - 最小値）を返します。

レイヤリレーションでマッチする地物の属性値の集計値を返します。

フィールドまたは式の標準偏差を返します。

フィールドまたは式の合計値を返します。

パラメータとして渡されたすべての値を、配列として返します。

配列の値をすべて含んでいる配列の場合、trueを返します。

値が最後に追加された配列を返します。

すべての配列を連結して、一つの配列として返します。

配列に指定された値が含まれている場合、trueを返します。

指定された配列の、異なる（distinctな）値の配列を返します。

式がtrueと判定した要素だけを含む配列を返します。

配列内の値のインデックス（最初のものは0）を返します。値が見つからない場合は-1を返します。

配列の最初の値を返します。

式で評価した結果を配列として返します。

配列のN番目の値（最初の値は0）を返します。

指定された位置に値が挿入された配列を返します。

配列array1の要素が一つでも配列array2に存在する場合、trueを返します。

配列の最後の値を返します。

配列の要素の数を返します。

値を先頭に追加した配列を返します。

指定された値が削除された配列を返します。

指定された位置（インデックス）の要素が削除された配列を返します。

逆順にした配列を返します。

配列の一部を返します。start_posとend_posの引数で定義されます。

ソートされた配列を返します。

配列要素を区切り文字で連結した文字列を返します。空の値を置き換える文字列を指定できます。

連続した数字からなる配列を作ります。

正規表現のグループによってキャプチャされた文字列を、配列として返します。

文字列を区切り文字で配列に分割します。

CMYK（シアン、マゼンタ、イエロー、ブラック）で指定した色を表す文字列を返します。

CMYKA（シアン、マゼンタ、イエロー、ブラック、アルファ）で指定した色を表す文字列を返します。

グレースケールフィルタを適用した色の文字列表現を返します。

HSL（色相、彩度、輝度）で指定した色を表す文字列を返します。

HSLA（色相、彩度、輝度、アルファ）で指定した色を表す文字列を返します。

HSV（色相、彩度、明度）で指定した色を表す文字列を返します。

HSVA（色相、彩度、明度、アルファ）で指定した色を表す文字列を返します。

比率に基づいて混合した色を表すRGB文字列を返します。

色の特定成分を返します。

RGB（赤、緑、青）で指定した色を表す文字列を返します。

RGBA（赤、緑、青、アルファ）で指定した色を表す文字列を返します。

色とステップのマップ型オブジェクトで定義されたグラデーションランプを返します。

指定した色を基準に、より暗い（または明るい）色の文字列を返します。

より明るい（または暗い）色を返します。

プロジェクトのカラースキーマの色を返します。

カラーランプから色を表す文字列を返します。

保存済みランプの色を表す文字列を返します。

色の文字列の成分を設定します。

引数リストを順に評価し、NULLではない最初の値を返します。
この関数は、任意の数の引数をとることができます。

条件をテストし、それに応じて異なる結果を返します。

value1がvalue2と等しい場合、nullを返します。それ以外の場合、value1を返します。

正規表現に一致する最初の位置を返します。部分文字列が見つからない場合、0を返します。

式を評価し、エラーでない値を返すことを保証します（いわゆる例外処理）。式がエラーを返す場合、指定した値を返します。指定値がない場合はnullを返します。

Decodes a string in the Base64 encoding into a binary value.

指定した方法で文字列のハッシュを生成する

文字列からmd5ハッシュを作る

文字列からsha256ハッシュを作る

Encodes a binary value into a string, using the Base64 encoding.

文字列を日付型オブジェクト（date）に変換します。オプションとして、文字列をパースするためのフォーマット形式を指定できます。詳しくは、 QDate::fromString をご覧ください。

文字列を日時型オブジェクト（datetime）に変換します。オプションとして、文字列をパースするためのフォーマット形式を指定できます。詳しくは、 QDate::fromString をご覧ください。

座標を度・分単位に変換します。

座標を度、分、秒形式に変換します。

文字列を整数値に変換します。整数値に変換できない場合は何も返されません（例えば '123asd' は不正です）

文字列をインターバル型に変換します。日付や月、時間などを取得することに利用できます。

文字列を実数型に変換します。変換できない場合は何も返されません（例えば'123.56asd'は不正です）。フィールドの精度が変換結果の精度より小さい場合、保存時に数値が丸められます。

数値を文字列に変換します。

文字列を時間型オブジェクト（time）に変換します。オプションとして、文字列をパースするためのフォーマット形式を指定できます。詳しくは、 QDate::fromString をご覧ください。

2つの日付や日時の差を返します。
差は Interval 型として返されるので、有用な情報を抽出するためには次のいずれかの関数と一緒に使用する必要があるでしょう:

• year
• month
• week
• day
• hour
• minute
• second

1970-01-01T00:00:00.00(Qt.UTC)からの経過時間をdatetime型を返す。

日付型から日を取り出します。インターバル型からは日単位の長さを取り出します。

日付型（date）または日時型（datetime）から日を取り出します。

日付または日時の曜日を表す整数を返します。返される値は0から6で、0が日曜日、6が土曜日に対応します。

Unixエポックと日付値とのインターバルをミリ秒単位で返します。

日付型または文字列をカスタム形式でフォーマットします。詳しくは QDateTime::toString を参照してください。

時間型（time）または日時型（datetime）から時の部分を取り出します。インターバル型からは時間数を取り出します。

時間型（time）または日時型（datetime）から時の部分を取り出します。

Creates a date value from year, month and day numbers.

Creates a datetime value from year, month, day, hour, minute and second numbers.

Creates an interval value from year, month, weeks, days, hours, minute and seconds values.

Creates a time value from hour, minute and second numbers.

日時型（datetime）または時間型（time）から分の部分を取り出します。インターバル型（interval）からは長さを分の単位で取り出します。

時間（time）または日時（datetime）から分の部分を取り出します。

日付型（date）から月の部分を取り出します。インターバル型（interval）からは長さを月単位で取り出します。

日付型（date）または日時型（datetime）から月の部分を取り出します。

現在の時間を返します。この関数は静的で、評価時に一貫した値を返します。

日時型（datetime）または時間型（time）から秒の部分を取り出します。インターバル型からは長さを秒単位を取り出します。

時間型または日時型から秒の部分を取り出します。

文字列を日付型オブジェクト（date）に変換します。オプションとして、文字列をパースするためのフォーマット形式を指定できます。詳しくは、 QDate::fromString をご覧ください。

文字列を日時型オブジェクト（datetime）に変換します。オプションとして、文字列をパースするためのフォーマット形式を指定できます。詳しくは、 QDate::fromString をご覧ください。

文字列をインターバル型に変換します。日付や月、時間などを取得することに利用できます。

文字列を時間型オブジェクト（time）に変換します。オプションとして、文字列をパースするためのフォーマット形式を指定できます。詳しくは、 QDate::fromString をご覧ください。

日付型から週番号を取り出します。インターバル型からは週単位の長さを取り出します。

日付型（date）または日時型（datetime）から週番号を取り出します。

日付型（date）から年の部分を取り出します。インターバル型からは年単位で長さを取り出します。

日付型（date）または日時型（datetime）から年の部分を取り出します。

（ディレクトリも拡張子もない）ファイル名を返します。

ファイルが存在する場合、trueを返します。

ファイルパスの、拡張子付きファイル名を返します。ディレクトリは含みません。

ファイルのパスの、ディレクトリ部分を返します。

ファイルサイズを返します。単位はbytes。

ファイルのパスの拡張子部分を返します。

ファイルパスがディレクトリの場合、trueを返します。

ファイルパスがファイルの場合、trueを返します。

Only usable in an embedded form context, this function returns the current, unsaved value of a field in the parent form currently being edited. This will differ from the parent feature's actual attribute values for features which are currently being edited or have not yet been added to a parent layer. When used in a value-relation widget filter expression, this function should be wrapped into a 'coalesce()' that can retrieve the actual parent feature from the layer when the form is not used in an embedded context.

現在編集中のフォームまたはテーブルで、属性の（未保存の）値を返します。

2つの文字列間のハミング距離を返します。この距離は、入力文字列の対応する位置にある異なった文字の数です。入力文字列は同じ長さでなければならず、大文字と小文字を区別して比較されます。

2つの文字列の間のLevenshtein編集距離を返します。これは、ある文字列を別の文字列に変更するために必要な文字編集（挿入、削除または置換）の最小数に相当します。
Levenshtein距離は、2つの文字列間の類似性の尺度です。距離が小さいほど文字列はより似ており、距離が長いほど文字列が異なることを示します。距離は大文字と小文字を区別します。

2つの文字列の、最も長い共通部分を返します。たとえば、 "ABABC"と "BABCA"の最も長い共通部分は"ABC"です。部分文字列は大文字と小文字を区別します。

文字列のSoundex表現を返します。Soundexは音声マッチングアルゴリズムで。同じ音の文字列は同じSoundexコードで表現されます。

環境変数を取得し、その内容を文字列として返します。変数が見つからない場合、NULLが返します。 この関数は、ドライブ文字やパスプレフィックスなどのシステム固有の設定を取得するために有用です。環境変数の定義はオペレーティングシステムによって異なりますので、システム管理者またはオペレーティングシステムのマニュアルを参照して設定方法を確認してください。

文字列で渡された式を評価します。これを使えば、コンテキスト変数またはフィールドとして渡されたパラメータを動的に展開できます。

Evaluates a template which is passed in a string. Useful to expand dynamic parameters passed as context variables or fields.

指定されたレイヤが表示されている場合、trueを返します。

該当するレイヤのプロパティまたはメタデータの値を返します。

変数名の値を返します。

この関数は、第３引数の式で使われる変数を設定します。同じ計算結果を別の場所で繰り返し使用する必要があるような、複雑な式を構成する際に使われます。

地物の面積を返します。この関数で計算される面積は、現在のプロジェクトの楕円体の設定と領域単位の設定の両方を反映します。 例えば、プロジェクトに回転楕円体が設定されている場合、楕円体面積になり、設定されていない場合、平面上の面積になります。

現在の地物のジオメトリを返します。他の関数と組み合わせて使います。

線の長さを返します。ポリゴンの境界の長さが必要な場合は、$perimeter を使用してください。 計算には、現在のプロジェクトの楕円体の設定と距離単位の設定の両方が影響します。例えば、プロジェクトに楕円体が設定されている場合、楕円体長（測地線長）になり、楕円体が設定されていない場合、平面長になります。

現在の地物の周長を返します。この関数で計算される周囲は、現在のプロジェクトの楕円体の設定と距離単位の設定の両方が影響します。 たとえば、プロジェクトに楕円体が設定されている場合、計算された周長は楕円体長（測地線）になり、楕円が設定されていない場合、計算された周長は平面長になります。

現在の地物のx座標を返します。

現在の地物のジオメトリのx座標を抜き出します。

現在の地物のy座標を返します。

現在の地物のジオメトリのy座標を抜き出します。

線を構成する頂点の二等分線角度（平均角度）を返します。 角度は北から時計回りです。例えば、北向きのセグメント（0度）と東向きのセグメント（90度）の共通頂点では、45になります。

ポリゴンの面積を返します。常に、このジオメトリの座標参照系で平面的として計算されます。単位は座標参照系の単位と一致します。 この面積は、プロジェクトの楕円体と面積単位設定にもとづいた楕円体として計算される $area 関数とは微妙に異なります。

point_aから見たpoint_bの方位（北をゼロにして時計回り）をラジアンで返します。

ジオメトリのクロージャ（トポロジカル境界）を返します。例えば、ポリゴンでは外側と内側のリングが、線では両端の頂点が、トポロジカル境界です。点やコレクションには境界が定義されていないため、nullが返されます。

ジオメトリのバウンディングボックスを返します。計算は、ジオメトリの座標参照系で行われます。

ジオメトリのバウンディングボックスの高さを返します。計算は、このジオメトリの座標参照系で行われます。

ジオメトリのバウンディングボックスの幅を返します。計算は、このジオメトリの座標参照系で行われます。

ジオメトリからの距離が一定値未満の領域（バッファ）を返します。距離の計算は、ジオメトリの座標参照系で行われます。

線に沿って可変幅のバッファを作成します。バッファの直径は各頂点のm値に従って変化します。

ジオメトリの重心を返します。

Returns a closed line string of the input line string by appending the first point to the end of the line, if it is not already closed. If the geometry is not a line string or multi line string then the result will be null.

geometry2に最も近いgeometry1上の点を返します。

ジオメトリを集約したマルチパートのジオメトリを返します。

ジオメトリ部分は、関数の引数として個別に指定します。

２つのジオメトリの結合を返します。

ジオメトリが他のジオメトリを包含するかどうかをテストします。 ジオメトリbの点がジオメトリaの外側になく、bの内部の少なくとも1つの点がaの内部にある場合に true を返します。

凸包（convex hul）を返します。すべてのジオメトリを含む最小面積のポリゴンです。

ジオメトリが他のジオメトリと交差するかどうかをテストします。ジオメトリが全部ではなく一部に共通する内部点を持つ場合、trueを返します。

geometry_aのうち、geometry_bと交差しない部分を表すジオメトリを返します。

空間的に交差していないかどうかをテストします。空間を共有しない場合、trueを返します。

２つのジオメトリ間の最小距離を返します。

インデックスで指定した点までの、ジオメトリに沿った距離を返します。

ジオメトリの最後のノード（点）を返します。

線ジオメトリの始点と終点を指定量だけ延長します。最初と最後のセグメントを、その方位に向けて延長します。距離の単位はジオメトリの座標参照系を使います。

ポリゴンの外側のリングを返します。ジオメトリがポリゴンではない場合は、nullになります。

線または曲線のジオメトリを、xとyで指定した距離だけ並行移動させてできるポリゴンを返します。

頂点のXとYを入れ替えたジオメトリを返します。緯度と経度を間違えたジオメトリを修復する際に便利です。

ポリゴンのジオメトリに右手ルールを強制します。 右手ルールとは、ポリゴンの境界線の右手側が必ず内側になることで、外側の輪郭線は時計回りに描かれ、ポリゴンの穴の輪郭線は反時計回りに描かれます。シェープファイルは右手ルールです。

GMLのジオメトリを返します。

Well-Known Binary（WKB）形式からジオメトリを返す

Well-known text（WKT）のジオメトリを返します。

Returns the Well-Known Binary (WKB) representation of a geometry

SRIDメタデータのないWell-known text（WKT）表現を返します。

地物のジオメトリを返します。

ジオメトリコレクションから特定の要素を返します。入力ジオメトリがコレクションではない場合、nullを返します。

ジオメトリ間のハウスドルフ距離（Hausdorff）を返します。ハウスドルフ距離は、２つのジオメトリがどれほど類似しているかを測る指標で、距離が近いほど類似したジオメトリを示します。
オプションとしてdensify関数を指定できます。指定されていない場合は、標準的なハウスドルフ距離近似が使用されます。この近似は、大きなサブセットでは十分に正確です。例えば、

• ほぼ平行で、ほぼ同じ長さの線の類似性を指標にして、線形ネットワークのマッチングさせる場合。
• ジオメトリの類似性のテストする場合。

デフォルトの近似が不十分な場合、オプションのdensify関数を指定します。この関数を指定すると、離散ハウスドルフ距離を計算する前にセグメントの稠密化が実行されます。パラメータは緻密化比率で、各セグメントはこの比率で等しい長さのサブセグメントに分割されます。稠密化比率を小さくすれば、距離は真のハウスドルフ距離に近づきます。

point_aとpoint_bの間の傾斜角を返します。

ポリゴンの特定の内側のリングを返します。ジオメトリがポリゴンではない場合、nullを返します。

2つのジオメトリの共有部分を表すジオメトリを返します。

ジオメトリが交差するかどうかテストします。ジオメトリが空間的に交差（空間の一部を共有）する場合はtrueを、そうでなければfalseを返します

ジオメトリのバウンディングボックスが別のジオメトリのバウンディングボックスに重なるかどうかをテストします。空間的に交差する場合はtrueを、そうでない場合はfalseを返します

線が閉じている（開始点と終了点が一致している）場合はtrueを、そうでない場合はfalseを返します。ジオメトリが線ではない場合、nullを返します。

ジオメトリが空の場合はtrue、空でないならfalse、ジオメトリが存在しないならNULLを返します。is_empty_or_nullも参照してください。

ジオメトリがNULLか空の場合はtrue、それ以外ならfalseを返します。この関数は、 '$geometry IS NULL or is_empty($geometry)'に似ています。

Returns true if the geometry is of Multi type.

ジオメトリが有効（OGCの規約に合う2Dジオメトリ）な場合、trueを返します。

文字列の文字数、または線の長さを返します。

文字列の文字数を返します。

始点から線に沿って測った距離にある点での、線の方角を返します。方角の単位は度で、北から時計回りです。 ノード上では平均角度になります。

始点から線に沿って測った距離にある点を返します。

基準点から線にもっと近い点の、始点から線に沿って測った距離を返します。

複数の線をマージした、単一の線ジオメトリを返します。線でない場合、nullを返します。

（始点から測った距離で指定した）始点から終点までを切り出した直線・曲線のジオメトリを返します。Z値とM値は線形内挿されます。

点のm値を返します。

Returns the maximum m (measure) value of a geometry.

Returns the minimum m (measure) value of a geometry.

円形のポリゴンを作成します。

楕円形のポリゴンを作成します。

一連の点ジオメトリから線ジオメトリを作成します。

線の頂点は、関数の引数として個別に指定します。

xとyの値を指定して点ジオメトリを作成します。

x, yおよびm値から点ジオメトリを作成します。

外側のリングおよび内側のリング（オプション）でポリゴンを作成します。

３点を指定して長方形を作成します。

正多角形を作成します。

対角線を指定して正方形を作成します。

三角形のポリゴンを作成します。

ジオメトリの最小包囲円を返します。すべてのジオメトリを包み込む最小の円を表します。

入力ジオメトリのすべてのノード（点）からなるマルチポイントジオメトリを返します。

ジオメトリコレクション内のジオメトリの数を返します。入力ジオメトリがコレクションでない場合、nullを返します。

ポリゴンまたはジオメトリコレクション中の内側のリングの数を返します。ポリゴンでもコレクションでもない場合、nullを返します。

ジオメトリの頂点数を返します。

ポリゴンまたはジオメトリコレクション中のリング（外側のリングを含む）の数を返します。ポリゴンでもコレクションでもない場合はnullを返します

線ジオメトリを側面方向にオフセットさせたジオメトリを返します。距離の単位はジオメトリの座標参照系です。

与えられた基準によってマルチジオメトリを並べ替えます。

バウンディングボックスのジオメトリを返します。

ジオメトリが別のジオメトリに重なるかどうかをテストします。ジオメトリが空間を共有していて同じ次元であり、かつ、互いが完全に含まれない場合、trueを返します。

ポリゴンの周長を返します。常にジオメトリの座標参照系で平面上で計算されます。面積の単位はCRSの単位と一致します。 この点で、プロジェクトの楕円体と面積単位設定にもとづいた楕円体計算が行われる $perimeter 関数とは異なります。

ジオメトリの特定のノードを返します。

ジオメトリの表面上に存在することが保証される点（内部保証点）を返します。

ポリゴンの表面から最も離れた内部点を近似的に計算します。 使用するpolylabelアルゴリズム（Vladimir Agafonkin, 2016）は、指定された許容範囲内で「到達不能極」を見つける反復的手法です。許容範囲を厳しくすると反復計算の時間がかかります。 到達不能極（Pole of inaccessibility, PIA）とは、陸上で最も海から遠い点、または海上で最も陸から遠い点のことです。

指定した距離と方位（単位はラジアン）、標高を使って、始点から投影された点を返します。

2つのジオメトリの関係のDimensional Extended 9 Intersection Model (DE-9IM)表現をテストします。

２つのジオメトリの関係のDimensional Extended 9 Intersection Model (DE-9IM)表現を返します。

（点の順序を逆にして）線の向きを反転します。

回転したジオメトリを返します。計算はジオメトリの座標参照系で行われます。

入力ジオメトリのすべてのセグメントからなる線ジオメトリ（マルチパート）を返します。

geometry1とgeometry2を結合する最短の直線を返します。向きは、geometry1を始点とし、geometry2を終点とします。