Documentation
ドキュメントの検索
karat

+

K

APIリファレンス ↗
分析Fusion式関数ライブラリ
Feedback

注: 以下の翻訳の正確性は検証されていません。AIPを利用して英語版の原文から機械的に翻訳されたものです。

関数ライブラリ

コア関数

これらの関数は Fusion のデフォルトメソッドです。

abs(value: number): number

数値の絶対値（つまり、符号なしの数）を計算します。

例：abs(-2) は、値 2 を返します。

引数

  • value: NUMBER

acos(value: number): number

数値の逆余弦を返します。逆余弦は、余弦が数値である角度です。返される角度は、0 から Π の範囲でラジアンで与えられます。

例：acos(1) は、値 0 を返します。

引数

  • value: NUMBER

all_token_match(value: any): same_as_first_argument

検索やルックアップをトークン化された方法で行うことができる修飾子付きの value を返します。この修飾子では、すべての用語が結果のどこかに表示されます。

引数

  • value: ANY

any_token_match(value: any): same_as_first_argument

検索やルックアップをトークン化された方法で行うことができる修飾子付きの value を返します。この修飾子では、用語のうち少なくとも 1 つが結果のどこかに表示されます。

引数

  • value: ANY

array([arg: any, ...]): string

すべての入力属性の配列を作成します。結果の配列は[角括弧]で囲まれます。すべての属性は、1 つのセルにリストされます。

例：array('John', 'Mary', 'Richard') は、配列 [ John, Mary, Richard ] の結果となります。

注：属性が文字列の場合は、'シングルクォーテーション'で囲む必要があります。

引数

  • arg: ANY

array_concat([array: array, ...]): array

すべての入力配列を 1 つの配列に連結します。

例：セル A1 に配列 [1,2,3] があり、セル A2 に配列 [4,5,6] があるとします。Array_concat(A1,A2) は、新しい配列 [1,2,3,4,5,6] を返します。

引数

  • array: ARRAY

array_contains(array: 配列, value: 任意): boolean

array が value を含んでいるかどうかをチェックします。配列に値が含まれている場合、関数は true を返します。

例: 配列 [ John, Mary, Richard ] がセル E7 にある場合、array_contains(E7, 'Richard') を実行すると、配列内に 'Richard' という値が存在するかどうかをチェックします。この場合、関数は True を返します。array_contains(E7, 'Louise') を入力した場合、関数は False を返します。

引数

  • array: 配列
  • value: 任意

array_difference(array: 配列, [differenceArrays: 配列, ...]): 配列

最初の配列にある他の配列にないすべてのユニークな要素を返します。順序は保証されません。

例: セル E7 にある配列 [ John, Mary, Richard, Richard ] と、セル E8 にある配列 [ John, Mary, Bob] が与えられた場合、array_difference(E7, E8) は [ Richard ] を返します。

引数

  • array: 配列
  • differenceArrays: 配列

array_distinct([value: 任意, ...]): 配列

入力引数の重複しない値のみを含む配列を返します。

例: array_distinct(array(3, 2, 1), 4, array(1, 2)) は、配列(3, 1, 4, 2) を返します。

注: 値の順序は保持されません。また、値に付加されたタグ(例: fuzzy や exact)は削除されます。

引数

  • value: 任意

array_flatten([arg: 任意, ...]): 文字列

すべての入力属性の配列を作成します。結果の配列は [角括弧] で囲まれます。すべての属性が単一のセルにリストされます。 この関数は array と似ていますが、セル範囲や配列を左から右、行ごとに値を取得して折りたたみます。範囲内の空の値やエラーは無視されます。

例: array_flatten('John', A1:B2) で、A1 = array('Zoe', 'Charles')、A2 = 'Mary'、B2 = 'Richard' の場合、配列 [ John, Zoe, Charles, Mary, Richard ] が結果となります。セル A1 の配列が出力に展開され、空のセル B1 がスキップされていることに注意してください。

注: 属性が文字列の場合、'シングルクォーテーション' で囲む必要があります。

引数

  • arg: 任意

array_get_at_index(array: 配列, index: 数値): 任意

指定された array から、位置 index（1 から始まるインデックス）の要素を返します。

例: 配列 [ John, Mary, Richard ] がセル E7 にある場合、位置 3 の属性を確認したい場合は、array_get_at_index(E7, 3) を使用できます。これにより、配列の 3 番目の属性である Richard が返されます。

引数

  • array: 配列
  • index: 数値

array_get_first(array: 配列): 任意

array の最初の要素を取得します。

引数

  • array: 配列

array_get_last(array: 配列): 任意

array の最後の要素を取得します。

引数

  • array: 配列

array_intersection(array: array, [intersectionArrays: array, ...]): array

すべての指定された配列に存在する一意の要素をすべて返し、順序については保証しません。

例えば: 配列 [ John, Mary, Mary, Richard ]がセルE7にあり、配列 [ John, Mary, John, Bob]がセルE8にある場合、array_intersection(E7, E8)は [ John, Mary ]を返します。

引数

  • array: 配列
  • intersectionArrays: 配列

array_length(array: array): number

指定した配列の長さを返します。

例えば: 配列 [ John, Mary, Richard ]がセルE7にあり、その配列の長さを決定したい場合、array_length(E7)と書きます。この関数は値3を返します。なぜなら、配列には3つの属性があるからです。

引数

  • array: 配列

array_slice(array: array, start_index: number, [end_index: number]): array

start_index（含む）からend_index（含む）までのarrayをスライスし、配列を返します。

例えば: 配列 [ John, Mary, Richard ]がセルE7にある場合、array_slice(E7, 1, 2)は [ John, Mary ]を返します。 もしstart_indexがゼロまたは配列の長さより大きい場合、空の配列が返されます。例：array_slice(E7, 5, 2) → []。もしstart_indexが負の場合、それは配列の最後からのオフセットとして使用されます。例：array_slice(E7, -2, 2) → [ Mary ]。もしend_indexがゼロまたは配列の長さより大きい場合、配列の最後までの部分配列が抽出されます。例：array_slice(E7, 2, 5) → [ Mary, Richard ]。もしend_indexが負の場合、それは配列の最後からのオフセットとして使用されます。例：array_slice(E7, 1, -2) → [ John, Mary ]。

引数

  • array: 配列
  • start_index: 数値
  • end_index: 数値

array_sort(array: array, [sort_direction: any]): array

指定された配列を昇順に並べ替えて返します。2つ目のパラメーターとしてFALSEまたは'DESC'を指定すると、降順に並べ替えます。

例えば: 配列 [ 3, 4, 1 ]がセルE7にあり、その配列を並べ替えたい場合、array_sort(E7, 'DESC')と書きます。この関数は配列 [ 4, 3, 1 ]を返します。

引数

  • array: 配列
  • sort_direction: 任意

array_zip([array: array, ...]): array

グループ化された要素の配列を作成します。そのうち最初のものは指定された配列の最初の要素を含み、2つ目は2つ目の要素を含み、というように続きます。結果として得られる配列の長さは、最も短い入力配列の長さと等しくなります。

例えば: セルA1に配列 ['a', 'b', 'c'] とセルA2に配列 [1, 2, 3]がある場合、array_zip(A1, A2)は新しい配列 [ [ 'a', '1' ], [ 'b', '2' ], [ 'c', '3' ] ]を返します。

引数

  • array: 配列

asin(value: number): number

数値の逆正弦、またはアークサインを返します。アークサインはその正弦が数値である角度です。返される角度はラジアンで、範囲は-π/2からπ/2までです。

例えば: asin(-1)は値 -π/2を返します。

引数

  • value: 数値

atan(value: 数値): 数値

数値の逆正接を返します。逆正接は、その数値が正接である角度です。返される角度は、範囲 -Π/2 から Π/2 までのラジアンで与えられます。

例えば：atan(0) は値 0 を返します。

引数

  • value: 数値

atan2(x_num: 数値, y_num: 数値): 数値

指定された x 座標と y 座標の逆正接、または逆正接を返します。逆正接は、x 軸から原点 (0, 0) を含む直線と、座標 (x_num, y_num) を持つ点までの角度です。角度は -Π から Π までのラジアンで与えられ、-Π は除外されます。

例えば：atan2(1,1) は値 0.785398163 を返します。

引数

  • x_num: 数値
  • y_num: 数値

avg([range: 範囲, ...]): 数値

指定した 範囲 の数値平均を計算します。この範囲は、値のセットまたは値の範囲として入力できます。

例えば：avg(5, 7, 11) は 7.66 を返します。

引数

  • range: 範囲

binary([value: 任意, ...]): バイナリ

数値からバイナリオブジェクトを作成します。すべての数値は符号なしバイト (0-255) として考慮されます。上位ビットは無視されます。

例えば：binary(0, 0, 127)。

引数

  • value: 任意

branch(dataset_path: 文字列, branch_name: 文字列): 最初の引数と同じ

branch_name でタグ付けされた dataset_path を返します。検索で使用するブランチを指定するために、ルックアップの最初の引数に適用します。

注意: 新たにインデックス化されたデータセットが見つからない場合は、ページを更新するか、データの検索と使用に移動し、インデックス化されたデータセットを選択し、次に更新ボタンを選択します。

引数

  • dataset_path: 文字列
  • branch_name: 文字列

case_toggle(value: 文字列): 文字列

大文字を小文字に、小文字を大文字に変更します。数字は変更されません。

引数

  • value: 文字列

cbrt(value: 数値): 数値

与えられた value の立方根を計算します。

例えば：cbrt(8) は 2 を返します。

引数

  • value: 数値

ceil(value: 数値): 数値

与えられた value の天井を計算し、小数点のない最も近い数値に切り上げます。

例: Ceil(5.2) は 6 を返します。

引数

  • value: NUMBER

checkbox([checked: ブール値], [label: 文字列]): ブール値

オプションのラベルを使用して、チェックされている場合は true を返し、それ以外の場合は false を返すチェックボックスをレンダリングします。チェックされた引数が提供されていない場合、デフォルトで false およびチェックされていない状態になります。

引数

  • checked: BOOLEAN
  • label: STRING

coalesce([arg: any, ...]): any

null でない最初の属性を返します。また、すべての属性が null の場合は null を返します。

例: 列 A に名前と null 値が混在しているとします。coalesce(行A) を使用すると、関数は最初に利用可能な名前を返します。

引数

  • arg: ANY

color(cell_value: any, [text_color: 文字列], [background_color: 文字列]): any

指定されたテキスト色と背景色のセルをレンダリングします。

引数

  • cell_value: ANY
  • text_color: STRING
  • background_color: STRING

concat([arg: 文字列, ...]): 文字列

複数の入力文字列属性を単一の文字列属性に連結します。

例: 最初の名前 John がセル A2 にあり、最後の名前 Smith がセル B2 にあるとします。concat 関数を使用して、C2 で concat(A2, ' ', B2) と入力すると、文字列 'John Smith' が得られます。

すべてのコレクションタイプの引数は再帰的にフラット化されます。 例えば、concat(array(1, 2), array(array(3, 4, 5)), 6) は文字列 '123456' を返します。

  • arg: STRING

concat_ws(separator: 文字列, [arg: 文字列, ...]): 文字列

separator で区切られたすべての引数を持つ単一の文字列属性に、複数の入力文字列属性を連結します。すべてのコレクションタイプの引数は再帰的にフラット化されます。

例: 最初の名前 John がセル A2 にあり、最後の名前 Smith がセル B2 にあるとします。concat_ws 関数を使用して、C2 で concat_ws('_', A2, B2) と入力すると、結果 'John_Smith' が得られます。

すべてのコレクションタイプの引数は、concat 関数と同様に再帰的にフラット化されます。

引数

  • separator: STRING
  • arg: STRING

cos(value: number): number

与えられた value の余弦を計算します。

例：cos(190) は 0.066 を返します。

引数

  • value: NUMBER

count([range: range, ...]): number

グループ内のアイテム数を返します。

例：特定の行内のオブジェクト数を知りたい場合、カウント関数を選択し、行をハイライトして値を取得できます。

引数

  • range: RANGE

count_distinct([range: range, ...]): number

グループ内の異なるアイテム数を返します。

例：count_distinct(columnA) は、この行内の異なるオブジェクト数を返します。この関数は配列にも適用でき、その配列内の異なるオブジェクト数を返します。

引数

  • range: RANGE

count_numeric([value: any, ...]): number

グループ内の数値アイテムの数をカウントします。

例：名前と数値が混在した100行があるとします。この行で数値アイテムのみの数を求めるには、count_numeric(A1:A100) を使用して値を取得します。

引数

  • value: ANY

countif(range: range, criteria: any): number

範囲 range 内で指定された criteria に等しいアイテムの数を返します。

例：列 A に動物のリストがあり、最初の100行で 'Dog' が何回リストされているか知りたい場合、countif(A1:A100, 'Dog') を使用してユニークなカウントを受け取ります。

引数

  • range: RANGE
  • criteria: ANY

countifs([range: range, criteria: any, ...]): number

すべての range、criteria のペアに対して、範囲 range 内で criteria に等しいアイテムの数を返します。

例：countifs(A1:A100, 'Red', B1:B100, 2) は、列 A に赤い値が含まれ、列 B に 2 が含まれるすべての値のカウントを返します。

引数

  • range: RANGE
  • criteria: ANY

date(year: number, month: number, day: number): date_time

year、month、dayを指定して日付を作成します。フォーマットは yyyy-MM-dd です。

年が 1900 より小さい場合（例：'97'）、年は 1900 からのオフセットとして解釈されます（例：'1997'）。

引数

  • year: NUMBER
  • month: NUMBER
  • day: NUMBER

date_add(dateOrDaysLeft: any, dateOrDaysRight: any): date_time

dateOrDaysLeft と dateOfDaysRight を足した結果の日付またはタイムスタンプを返します。各パラメーターは、日数または日数の一部、または日付を指定できます。日付は yyyy-MM-dd 形式でなければなりません。

例：2021-05-06 の 40 日後の日付を知りたいとします。この日付はセル D2 にあります。date_add(D2, 40) を使用して 2021-06-15 を取得します。例：2021-05-06 の半日後のタイムスタンプが欲しい場合。この日付はセル D2 にあります。date_add(D2, 0.5) を使用して 2021-05-06 12:00 を取得します。

引数

  • dateOrDaysLeft: ANY
  • dateOrDaysRight: ANY

date_diff(start: date_time, end: date_time): number

start から end までの日数を返します。日付は yyyy-MM-dd 形式でなければなりません。

例：2021-01-15 と 2021-06-15 の間の日数を知りたいとします。これらのセルはそれぞれ B2 と B5 にあります。date_diff (B2, B5) を使用して -151 日の差を得ます。

引数

  • start: DATE_TIME
  • end: DATE_TIME

date_format(date: date_time, format: string): string

日付/タイムスタンプ date を format の文字列で指定した形式の文字列に変換します。形式は yyyy-MM-dd の文字列のバリエーションが可能です。

例：2021-05-06 の日付を date_format('2021-05-06', 'MM-dd-yy') を使用して 05-06-21 に再フォーマットします。

引数

  • date: DATE_TIME
  • format: STRING

date_sub(dateOrDaysLeft: any, dateOfDaysRight: any): date_time

dateOrDaysLeft から dateOfDaysRight を引いた結果の日付またはタイムスタンプを返します。各パラメーターは、日数または日数の一部、または日付を指定できます。日付は yyyy-MM-dd 形式でなければなりません。

例：2021-05-06 の 40 日前の日付を知りたいとします。この日付はセル D2 にあります。date_sub(D2, 40) を使用して 2021-03-27 を取得します。例：2021-05-06 の半日前のタイムスタンプが欲しい場合。この日付はセル D2 にあります。date_sub(D2, 0.5) を使用して 2021-05-05 12:00 を取得します。例：セル D1 にある日付とセル D2 にある日付の間の日数の差を知りたい場合。date_sub(D1, D2) を使用します。

引数

  • dateOrDaysLeft: ANY
  • dateOfDaysRight: ANY

datepicker([selectedDateTime: date_time], [timePrecision: string]): date_time

選択した日付の日付ピッカーを返します。日付は、オプションで HH:mm（時間情報）を付けて yyyy-MM-dd 形式である必要があります。時間精度は 'NONE'、'MINUTE'、または 'SECOND' のいずれかでなければなりません。

引数

  • selectedDateTime: DATE_TIME
  • timePrecision: STRING

day_of_month(date: date_time): number

指定した日付/タイムスタンプ/文字列から月の日数を整数として抽出します。

例えば、日付 2021-06-18 がセル B2 にあるとします。 day_of_month(B2) は 18 を返します。

引数

  • date: DATE_TIME

day_of_year(date: date_time): number

指定した日付/タイムスタンプ/文字列から年の日数を整数として計算します。

例えば、日付 2021-06-18 がセル B2 にあるとします。 day_of_year(B2) は 169 を返します。

引数

  • date: DATE_TIME

document_metadata(key: string): string

ドキュメントのメタデータにアクセスします。実装するには、必要なメタデータフィールドの key を渡します。

サポートされているキー：

  • creator はドキュメントの作成者を返します（既知の場合）。
  • document_identifier はドキュメントの内部識別子を返します（例えば、submit_to_region_with_key 関数で使用されます）

例えば、 document_metadata('creator') はドキュメントの作成者のユーザー名を返します。

引数

  • key: STRING

dropdown(values: array, [selected_value: string], [allow_invalid: boolean], [placeholder_text: string]): any

提供された values 配列から選択できる値を持つドロップダウンをレンダリングします。 values は一意でなければなりません。各値はドロップダウンの文字列ラベルに変換されます。

例えば、=dropdown(array('red', 'blue', 'green')) は 'red', 'blue', 'green' の値を持つドロップダウンを作成します。

selected_value が提供された場合、それはドロップダウンのデフォルトの文字列ラベルを指定します。 selected_value はオプションで、null に設定することができ、これによりドロップダウンの選択が未選択の状態になります。 selected_value が設定され、選択されたラベルがもはや values 配列に存在しない場合（例えば、基礎となるデータが変更された場合）、結果は空のセルになります。

allow_invalid が true に設定されている場合、この挙動をオーバーライドし、以前に保存された選択を出力します。この結果は文字列のみで、文字列値のセットから前の選択を保持しようとするときにのみ推奨されます。

placeholder_text を使用すると、値が選択されていないときにドロップダウンにテキストを表示することができます（これはプロンプトや指示として便利です）

引数

  • values: ARRAY
  • selected_value: STRING
  • allow_invalid: BOOLEAN
  • placeholder_text: STRING

empty_cell(): any

空の結果を返します。 if や iferror 関数と組み合わせると便利です（例えば、if(not isnull(A1), A1, empty_cell())）

eq(value: any): same_as_first_argument

現在の value を等価性(==)の比較としてマークします。

ルックアップ関数の引数に適用して、検索動作を変更します。

引数

  • value: ANY

exact(value: any): same_as_first_argument

valueを修飾子でタグ付けし、検索やルックアップがvalueの完全一致を求めるようにする値を返します。

引数

  • value: ANY

exp(value: number): number

value の指数にeを引き上げた値を返します。定数eは2.718で、自然対数の基底となります。

例えば: exp(2)は7.389を返します。これは自然対数eを2の指数に引き上げた結果です。

引数

  • value: NUMBER

experimental_add_tags(value: any, tags: array): same_as_first_argument [EXPERIMENTAL]

tagsをvalueに追加し、新しくタグ付けされた値を返します。

引数

  • value: ANY
  • tags: ARRAY

experimental_copy_and_sync_button(label: string, folder: string, name: string, [exports: array], [onCompleteMessage: string], [onFailureMessage: string], [redirectToHomeAfterCompletion: boolean]): same_as_first_argument [EXPERIMENTAL]

labelというラベルのボタンを描画し、クリックするとスプレッドシートをfolderにコピーし、その名前をnameにします。

エクスポートは以下のパターンでコピーされます: '$name - Export $sheetName'. exportsで指定したシート名のエクスポートを制約することができます。エクスポートが欠落している場合、コピーは失敗します。完了メッセージと失敗メッセージはそれぞれonCompleteMessageとonFailureMessageで指定できます。redirectToHomeAfterCompletionがtrueに設定されている場合、ユーザーは操作完了後に自分のホームフォルダーにリダイレクトされます。

引数

  • label: STRING
  • folder: STRING
  • name: STRING
  • exports: ARRAY
  • onCompleteMessage: STRING
  • onFailureMessage: STRING
  • redirectToHomeAfterCompletion: BOOLEAN

experimental_error([value: string, ...]): any [EXPERIMENTAL]

エラーを出力します。

引数

  • value: STRING

experimental_get_tags(value: any): array [実験的]

valueに関連付けられたタグの配列を返します。

引数

  • value: ANY

experimental_io_blocking_function([extra_delay: number]): string [実験的]

I/Oがタイムアウトするまでブロックするテストメソッド。オプションで、タイムアウト後に待つ追加の遅延を指定して、I/O機能の動作が悪いことをシミュレートできます。

引数

  • extra_delay: NUMBER

experimental_range(width: number, [value: any, ...]): range [実験的]

範囲を出力します。

引数

  • width: NUMBER
  • value: ANY

experimental_remove_tags(value: any, [tags: array]): same_as_first_argument [実験的]

配列 tags 内のタグを value から削除し、または tags 引数が存在しない場合、value からすべてのタグを削除します。

引数

  • value: ANY
  • tags: ARRAY

factorial(value: number): number

与えられた value の階乗を計算します。

例: factorial(3) は 6 を返します。

引数

  • value: NUMBER

find(search_for: string, text_to_search: string, [starting_index: number]): number

文字列 text_to_search の最初の search_for のインデックスを返します。検索の starting_index をオプションで指定できます。

例: セルA1に 'The grey cat chased the grey mouse' というフレーズがあると仮定します。'grey' の最初のインスタンスのインデックスを決定するには、find('grey', A1) を実装してインデックス 5 を取得します。

引数

  • search_for: STRING
  • text_to_search: STRING
  • starting_index: NUMBER

floor(value: number): number

与えられた value の床を、小数点以下のない最も近い数値に切り捨てることで計算します。

例: floor(3.2) は 3 に丸められます。また、floor (-4.5) は -5 に丸められます。

引数

  • value: NUMBER

lookup_distinct(dataset_path: string, result_column: string, [行: string, value: string, ...]): any

dataset_pathのresult_columnから、行、valueペアで定義されたフィルターに一致する値を取得します。

例：lookup_distinct('/Users/me/myData', 'my_column', 'first_name', 'John')は、データセット'/Users/me/myData'でfirst_name = 'John'の行を検索し、'my_column'の一致するフィルターの値を取得します。

注：

  • Valueはexactまたはfuzzy関数を使用してラップすることができ、一致するかどうかを指定できます。Dataset_pathは、データセットのブランチを指定するためにbranch関数でラップできます。
  • 新しくインデックスされたデータセットが見つからない場合は、ページを更新するか、Find and use dataに移動し、Indexed datasetsを選択してから、更新ボタンを選択してください。

引数

  • dataset_path: STRING
  • result_column: STRING
  • 行: STRING
  • value: STRING

lookup_dropdown(dataset_path: string, result_column: string, [selected_value: string], [行: string, value: string, ...]): any

dataset_pathのresult_columnから提案された値を持つドロップダウンを返します。selected_valueは現在の値です。 selected_valueはnullに設定でき、これによりドロップダウンの選択が未選択状態になります。

例：lookup_dropdown('/Users/me/myData', 'my_column', NULL, 'first_name', 'John')は、'/Users/me/myData'の行でfirst_name = 'John'のオプションを持つドロップダウンを返します。この関数は、一致するフィルターの'my_column'の値を取得します。

注：新しくインデックスされたデータセットが見つからない場合は、ページを更新するか、Find and use dataに移動し、Indexed datasetsを選択してから、更新ボタンを選択してください。

引数

  • dataset_path: STRING
  • result_column: STRING
  • selected_value: STRING
  • 行: STRING
  • value: STRING

lookup_schema(datasource_path: string, [branch: string]): array

datasource_pathで指定されたデータソースの行名を返します。検索用のデータソースブランチをオプションで指定できます。

注：

  • 行名は配列として返されます。
  • 新しくインデックスされたデータセットが見つからない場合は、ページを更新するか、Find and use dataに移動し、Indexed datasetsを選択してから、更新ボタンを選択してください。

引数

  • datasource_path: STRING
  • branch: STRING

[DEPRECATED] lookup_set(dataset_path: string, result_column: string, [行: string, value: string, ...]): any

dataset_pathのresult_columnから、行、valueペアで定義されたフィルターを使用して結果をフィルター処理した無順序セットを返します。

例：lookup('/Users/me/myData', 'my_column', 'first_name', 'John', 'last_name', 'Doe')は、データセット'/Users/me/myData'でfirst_name = 'John'およびlast_name = 'Doe'の行を検索し、一致する行のmy_columnの値を取得します。

注：

  • Valueは、exactまたはfuzzy関数を使用してラップでき、一致が正確か曖昧かどうかを指定できます。
  • 新しくインデックスされたデータセットが見つからない場合は、ページを更新するか、Find and use dataに移動し、Indexed datasetsを選択してから、更新ボタンを選択してください。

引数

  • dataset_path: STRING
  • result_column: STRING
  • 行: STRING
  • value: STRING

lookup_sorted(dataset_path: string, result_column: string, sort_column: string, sort_direction: string, [行: string, value: string, ...]): any

dataset_pathのresult_columnから、sort_columnで指定されたsort_directionでソートされた値を返します。'result_column'のデータは、行、valueペアで定義された後続の引数を使用してフィルター処理できます。

注：

  • sort_column、result_column、および行は、データセットdataset_pathの行名でなければなりません。また、sort_directionは、昇順と降順を表す'ASC'または'DESC'のいずれかである必要があります。
  • Valueは、exactまたはfuzzy関数を使用してラップでき、一致が正確か曖昧かどうかを指定できます。
  • 新しくインデックスされたデータセットが見つからない場合は、ページを更新するか、Find and use dataに移動し、Indexed datasetsを選択してから、更新ボタンを選択してください。

引数

  • dataset_path: STRING
  • result_column: STRING
  • sort_column: STRING
  • sort_direction: STRING
  • 行: STRING
  • value: STRING

lower(value: string): string

valueで指定された文字列を小文字に変換します。

例：文字列'JANE DOE'がB2にある場合、lower(B2)は'jane doe'を返します。

引数

  • value: STRING

lpad(value: string, length: number, pad: string): string

valueの文字列属性をlengthの長さまでpadで指定された文字列で左詰めします。

例：列Aに電話番号の文字列を左詰めしたい場合、文字列'NY-'で左詰めします。各詰められた電話番号は13文字になります。実装には、lpad(A1, 13, 'NY-')を使用し、NY-##########を取得します。

引数

  • value: STRING
  • length: NUMBER
  • pad: STRING

lt(value: any): same_as_first_argument

現在のvalueを小さい（<）比較としてマークします。

検索動作を変更するためにルックアップ関数内の引数に適用します。

引数

  • value: ANY

lte(value: any): same_as_first_argument

現在のvalueを小さいか等しい（<=）比較としてマークします。

検索動作を変更するためにルックアップ関数内の引数に適用します。

引数

  • value: ANY

ltrim(value: string): string

value内の文字列の左端からスペースをトリムします。

例：文字列'John Smith'がセルA2にあり、先頭に4つのスペースがある場合、ltrim(A2)でスペースが削除されます。

引数

  • value: STRING

match(item: any, range: range, criteria: number): same_as_first_argument

指定された criteria を使用して range 内のアイテムを検索します。この関数は、そのアイテムの範囲内での相対位置（1から始まる）を返します。

criteria の可能なコードは以下の通りです：

  • 1 は item 以下の最大の値を見つけます。range で定義された範囲の値は昇順に配置する必要があります。
  • 0 は item と完全に等しい最初の値を見つけます。range で定義された範囲の値は任意の順序であっても構いません。
  • -1 は item 以上の最小の値を見つけます。range で定義された範囲の値は降順に配置する必要があります。

例：範囲 A1:A3 が値 5、25、38 を含む場合、式 match(25,A1:A3,0) は数値 2 を返します。なぜなら、25 は範囲内の 2 番目のアイテムだからです。

引数

  • item: ANY
  • range: RANGE
  • criteria: NUMBER

max([value: any, ...]): any

数値、日付、またはタイムスタンプのグループ内の最大値を返します。

例：max(1,5,23) は 23 を返します。また、max(A1:A100) はこの範囲内の最大値を返します。max(date(2021, 2, 2), date(2021, 2, 1)) は date(2021, 2, 2) を返します。max(parse_timestamp('2021-02-02 00:00:01', 'yyyy-MM-dd HH:mm:ss'), parse_timestamp('2021-02-02 00:00:02', 'yyyy-MM-dd HH:mm:ss')) はこのタイムスタンプ '2021-02-02 00:00:02' を返します。

引数

  • value: ANY

md5(value: any): string

文字列の MD5 ダイジェストを計算し、その値を 32 文字の 16 進数文字列として返します。

例：セル A2 に文字列 'John Smith' があるとします。md5(A2) は 6117323d2cabbc17d44c2b44587f682c を返します。

引数

  • value: ANY

mean([value: number, ...]): number

グループ内の数値の平均を返します。

例：mean(5,8,12) は 8.33 を返します。

引数

  • value: NUMBER

median([value: number, ...]): number

グループ内の数値の中央値を返します。

例：median(10, 11, 19, 20, 21) は 19 を返します。また、median(A1:A100) はこの範囲内の中央値を返します。

引数

  • value: NUMBER

min([value: any, ...]): any

数値、日付、またはタイムスタンプのグループ内の最小値を返します。

例：min(5,8,12) は 5 を返します。また、min(A1:A100) はその範囲内の最小値を返します。min(date(2021, 2, 2), date(2021, 2, 1)) は date(2021, 2, 1) を返します。min(parse_timestamp('2021-02-02 00:00:01', 'yyyy-MM-dd HH:mm:ss'), parse_timestamp('2021-02-02 00:00:02', 'yyyy-MM-dd HH:mm:ss')) はこのタイムスタンプ '2021-02-02 00:00:01' を返します。

引数

  • value: ANY

minute(date: date_time): number

date の分を整数として抽出します。

例：セル A2 にタイムスタンプ 2021-02-15 08:30:15 があるとしましょう。minute(A2) は 30 を返します。

引数

  • date: DATE_TIME

month(date: date_time): number

date の月を整数として抽出します。

例：セル A2 にタイムスタンプ 2021-02-15 08:30:15 があるとしましょう。month(A2) は 2 を返します。

引数

  • date: DATE_TIME

months_between(start: date_time, end: date_time): number

日付 start と end の間の月数を返します。

例：months_between('2020-02-15', '2022-01-15') は 23 を返します。

引数

  • start: DATE_TIME
  • end: DATE_TIME

multidropdown(values: array, [selected_value: array], [allow_invalid: boolean], [placeholder_text: string]): any

提供された values 配列から選択可能な値を持つドロップダウンをレンダリングします。dropdown 関数とは異なり、multidropdown ではユーザーが一度に複数の値を選択することができます。これらの values は一意でなければならず、各値は文字列としてのラベルに変換されます。

selected_value が提供された場合、それはドロップダウンのデフォルトの文字列ラベルを指定します。selected_value はオプションで、null に設定することもできます。これはドロップダウンの選択を未選択状態にします。

注：selected_value が設定され、選択したラベルが values 配列に見つからなくなった場合（たとえば、基になるデータが変更された場合）、結果は空のセルになります。

allow_invalid を true に設定すると、この動作が上書きされ、以前に保存された選択を出力します。この結果は現在、文字列のみであり、このモードは文字列値のセットから以前の選択を保持しようとするときのみ推奨されます。

placeholder_text は、値が選択されていないときにドロップダウンに表示されるテキストを設定します（これはプロンプトや指示として役立ちます）。

引数

  • values: ARRAY
  • selected_value: ARRAY
  • allow_invalid: BOOLEAN
  • placeholder_text: STRING

neq(value: any): same_as_first_argument

現在の value を不等号（!=）の比較としてマークします。

検索動作を変更するために、lookup 関数の引数に適用します。

引数

  • value: ANY

net_workdays(start_date: date_time, end_date: date_time, [holidays: any]): number

start_date と end_date の間の全労働日数を返します。労働日は週末を除きます。現時点では、この関数は休日を引数としてサポートしていません。

例えば、 net_workdays('2021-01-01','2021-02-01') は、1月中の労働日数23日を返します（休日は無視）。

引数

  • start_date: DATE_TIME
  • end_date: DATE_TIME
  • holidays: ANY

object(objectRid: string): object [実験段階]

指定した object RID のオブジェクトをロードします。

引数

  • objectRid: STRING

object_dropdown(object_set: array, [selected_object_rid: string], [placeholder_text: string]): object [実験段階]

オブジェクトセットからの提案値のドロップダウンを返します。selected_object_rid は、オブジェクトセットから現在選択されているオブジェクトの RID です。

引数

  • object_set: ARRAY
  • selected_object_rid: STRING
  • placeholder_text: STRING

object_set(objectSetRid: string, [paramKey: string, paramValue: any, ...]): array [実験段階]

指定した object set RID のオブジェクトセットをロードします。

引数

  • objectSetRid: STRING
  • paramKey: STRING
  • paramValue: ANY

parse_date(date_string: string, [formats: string, ...]): date

文字列を日付として解析します。複数の形式が指定されている場合、成功するまで順番に試します。

例： parse_date('25/01/2022', 'dd/MM/yyyy') は、2022年1月25日の日付を返します。

日付の形式設定と解析のためのパターンの詳細は、Java DateTimeFormatter documentationを参照してください。

引数

  • date_string: STRING
  • formats: STRING

parse_timestamp(timestamp_string: string, [formats: string, ...]): date_time

文字列をタイムスタンプとして解析します。複数の形式が指定されている場合、成功するまで順番に試します。

例： parse_timestamp('25/01/2022 12:03', 'dd/MM/yyyy HH:mm') は、2022年1月25日の正午3分の日付を返します。

引数

  • timestamp_string: STRING
  • formats: STRING

percentile(array: array, pp: number): number

配列内の pp 値が以下になる数値を返します。

  • array: 正/負の数値の配列で、必ずしもソートされているわけではありません。
  • pp: パーセンタイルで、0 から 1 の間になければなりません。pp=0 は配列の最小値を返し、pp=0.5 は中央値を返し、pp=1 は最大値を返します。
  • 例：
    • =percentile(array(7.25, 5.3, 8, 10), 0.25) は、配列の値の25%がそれ以下になる値6.7625を返します。
    • =percentile(array(12, 20, 10, 25, 28, 30, 34, 60), 0) は、配列の最小値10を返します。
    • =percentile(A2:A9, A13) は範囲とセル参照とともに使用することもできます。
    • =percentile(array_flatten(A2:A9), A13)

引数

  • array: ARRAY
  • pp: NUMBER

pow(value: number, power: number): number

value の power 乗の結果を返します。

例： pow(5, 2) は25を返します。

引数

  • value: NUMBER
  • power: NUMBER

product([value: any, ...]): number

式内のすべての数値の積を返します。

例： product(6*2) は12を返します。

引数

  • value: ANY

quarter(date: date_time): number

日付の年度四半期を整数として抽出します。

例：セル A1 に日付 2021-08-15 があるとします。Quarter(A1) は3を返します。なぜなら、この日付は年度の第3四半期にあるからです。

引数

  • date: DATE_TIME

query_params([key: string, value: string, ...]): string

URL クエリパラメーターで安全に使用できるように key, value のペアをエンコードします。

例： =query_params('k1', 'this is long', 'k2', 'v+2') は k1=this%20is%20long&k2=v%2B2 を返します。

引数

  • key: STRING
  • value: STRING

rank(number: number, collection: array, sortOrder: number): number

指定した数値の sort order によって順序付けられた数値の集合内でのランクを返します。ランキングは、集合内の他の値に対する数値の相対的な値となります。

sort order が 0 に等しい場合、数値のランキングは降順で表現されます。

sort order が非ゼロの数に等しい場合、ランキングは昇順で表現されます。

注：集合内のすべての非数値は無視されます。

例：セル A1、A2、A3、A4 にそれぞれ 94、79、83、96 の値があるとします。Rank(94, A1:A4, 1) は 2 を返します。なぜなら、94 はこの値の集合で 2 番目に高いランクの値だからです。この行の残りの数値のランクを決定したい場合は、集合の表現を A$1$4 に変更すべきです。これにより、範囲は変更されません。

引数

  • number：NUMBER
  • collection：ARRAY
  • sortOrder：NUMBER

regexp_replace(value: string, search: string, replace: string): string

value 中の search に一致するすべての部分文字列を replace で置き換えます。

例：列 A が動物のリストで、いくつかのセルに 'The' という文字列が含まれているとします（例：'The Dog'）。すべての 'The' を 'One' という文字列に置き換えたい場合、regexp_replace(A1, 'The', 'One') を実装するだけです。新しいセルは 'The Dog' ではなく 'One Dog' を表示します。セルの角をドラッグダウンして、列 A の残りに適用します。

引数

  • value：STRING
  • search：STRING
  • replace：STRING

reverse(value: string): string

value を逆転させて新しい文字列として返します。

例：Reverse('John Smith') は htimS nhoJ を返します。

引数

  • value：STRING

right(text: string, [num_chars: number]): string

文字列 text の末尾から num_chars で指定した文字数を返します。

例：文字列 'John Smith' がセル A2 にある場合、left(A2, 3) は Joh を返します。

引数

  • text：STRING
  • num_chars：NUMBER

round(value: number, decimalPlaces: number): number

value を decimalPlaces で指定した小数点以下の位数に丸めます。

例：Round(4.56, 1) は 4.6 を返します。Round(4.56, 0) は 5 を返します。

引数

  • value：NUMBER
  • decimalPlaces：NUMBER

rpad(value: string, length: number, pad: string): string

value の文字列属性を pad の文字列で指定された length まで右詰めします。

例：列 A の電話番号の文字列を '-NY' で右詰めしたいとします。各新しい番号には 13 文字があります。実装するには、rpad(A1, 13, '-NY') を使用して ##########-NY を取得します。

引数

  • value：STRING
  • length：NUMBER
  • pad：STRING

rtrim(value: string): string

value で指定された文字列の右端のスペースをトリムします。

例：セル A2 の文字列 'John Smith' に 4 つの後続スペースがある場合、rtrim(A2) はスペースを削除します。

引数

  • value：STRING

second(date: date_time): number

date の秒数を整数として抽出します。

例：セル A2 にタイムスタンプ 2021-02-15 08:30:15 があるとします。second(A2) は 15 を返します。

引数

  • date：DATE_TIME

[廃止予定] set_get_any(set: any): any

指定したセットからランダムな要素を取得します。

引数

  • set：ANY

[廃止予定] set_to_array(set: any): array

指定したセットを昇順でソートされた配列に変換します。

例：セル A1 に名前のセットがあるとします。set_to_array(A1) はこれらの名前を配列に変換します。

引数

  • set：ANY

sha1(value: any): string

属性の SHA-1 ダイジェストを計算し、その値を 40 文字の 16 進数の文字列として返します。

例：sha1('The cow jumped over the moon.') は 6e2780eb20fdaf78f6c8335d0b17526c7ef12a79 を返します。

引数

  • value：ANY

sin(value: number): number

value の正弦を計算します。

例：sin(140) は 0.98 を返します。

引数

  • value：NUMBER

split(text: string, delimiter: string): array

指定した delimiter で text を分割し、その断片を行に出力します。注：空の断片は無視されます。

例：セル A1 に文字列 'Jane | 24 | F' があるとしましょう。これを断片の配列に分割するためには、split(A1, '|') を使用して、'[ Jane , 24 , F ]' を取得します。

引数

  • text： STRING
  • delimiter： STRING

split_regex(text: string, delimiter: string): array

正規表現の文法を使用して、指定した delimiter で text を分割し、その断片を行に出力します。注：空の断片は無視されます。

例：セル A1 に文字列 '123ABCDE456FGHIJKL789MNOPQ012' があるとしましょう。これを非数字の断片の配列に分割するためには（つまり、任意の数字で分割するために）split_regex(A1, '\d+') を使用して、'[ ABCDE, FGHIJKL, MNOPQ ]' を取得します。

引数

  • text： STRING
  • delimiter： STRING

sqrt(value: number): number

value の平方根を計算します。

例： sqrt(16) は 4 を返します。

引数

  • value： NUMBER

stddev([value: number, ...]): number

グループ内の式の標本標準偏差を返します。

例：セル A1、A2、および A3 にそれぞれ値 23、45、32 があるとします。stddev(A1:A3) は 11.06 を返します。

引数

  • value： NUMBER

stddev_p([value: any, ...]): number

その引数が全体の母集団であると仮定して、グループ内の式の偏った標準偏差を返します。これらが母集団の一部のサンプルだけを表している場合は、代わりに STDDEV を使用してください。

引数

  • value： ANY

submit_to_region_with_key(button_label: string, document_identifier: string, region_name: string, should_submit: any, key_column: string, key_value: any, [column: string, value: any, ...]): string

クリックすると、指定したキーを持つ領域にデータを送信するボタンを作成します。

例：=submit_to_region_with_key('Submit!', 'ri.fusion.main.document...', 'submit_table', TRUE, 'key_column', A2:A10, 'value_column', B2:B10) は、A2 および B2:10 を指定したシート内のテーブル 'submit_table' の 'key_column' および 'value_column' の各行に送信します。

注意：パラメーターとして、受信するスプレッドシートに表示させたい key column、value のペアを好きなだけ含めることができます。ただし、送信される順序で表示させたいすべてのパラメーターをリストにする必要があります。

引数

  • button_label： STRING
    ボタンに表示する文字列を指定します。
  • document_identifier： STRING
    送信するデータが書き込まれるデータセットの RID を挿入します。RID はドキュメントの URL で識別でき、ri.fusion.main... のように見えます。
  • region_name： STRING
    書き込むテーブル領域の名前を指定します。まだこのテーブル領域を指定していない場合は、受信するスプレッドシートに移動し、'create table region' ウィジェットを使用し、テーブルに直感的な名前を付けます。
  • should_submit： ANY
    送信シートの特定の行に対応し、真偽値（つまり true/false）を含みます。should_submit が true の場合、データが送信されます。
  • key_column： STRING
    送信する値を格納する行のヘッダーを指定します。key_column の各値は一意でなければなりません。
  • key_value： ANY
    指定した key_column に送信する特定のセルまたはセル範囲を示します。
  • 行： STRING
  • value： ANY

submit_to_region_with_key_and_timestamp(button_label: string, document_identifier: string, region_name: string, should_submit: any, timestamp_column: string, key_column: string, key_value: any, [column: string, value: any, ...]): string

クリックすると、指定したキーを持つ領域にデータを送信するボタンを作成します。

例：=submit_to_region_with_key_and_timestamp('Submit!', 'ri.fusion.main.document...', 'submit_table', TRUE, 'time', 'key_column', A2:A10, 'value_column', B2:B10) は、A2 および B2:10 を指定したシート内のテーブル 'submit_table' の 'key_column' および 'value_column' の各行に送信します。現在のタイムスタンプが 'time' 行に送信されます。

注意：パラメーターとして、受信するスプレッドシートに表示させたい key column、value のペアを好きなだけ含めることができます。ただし、送信される順序で表示させたいすべてのパラメーターをリストにする必要があります。

引数

  • button_label： STRING
    ボタンに表示する文字列を指定します。
  • document_identifier： STRING
    送信するデータが書き込まれるデータセットの RID を挿入します。RID はドキュメントの URL で識別でき、ri.fusion.main... のように見えます。
  • region_name： STRING
    書き込むテーブル領域の名前を指定します。まだこのテーブル領域を指定していない場合は、受信するスプレッドシートに移動し、'create table region' ウィジェットを使用し、テーブルに直感的な名前を付けます。
  • should_submit： ANY
    送信シートの特定の行に対応し、真偽値（つまり true/false）を含みます。should_submit が true の場合、データが送信されます。
  • timestamp_column： STRING
    現在のタイムスタンプを送信する行のヘッダーを指定します。
  • key_column： STRING
    送信する値を格納する行のヘッダーを指定します。key_column の各値は一意でなければなりません。
  • key_value： ANY
    指定した key_column に送信する特定のセルまたはセル範囲を示します。
  • 行： STRING
  • value： ANY

submit_to_region_with_key_and_timestamp_lazy(button_label: string, document_identifier: string, region_name: string, should_submit: any, timestamp_column: string, key_column: string, key_value: any, [column: string, value: any, ...]): string

submit_to_region_with_key とまったく同じように動作しますが、送信する値はクリック時に計算し、ターゲット領域の情報をキャッシュします。大きな範囲を送信する場合や、短時間に同じ領域に複数回送信することを予測している場合にこれを使用してください。

クリックすると、指定したキーを持つ領域にデータを送信するボタンを作成します。

例：=submit_to_region_with_key_and_timestamp_lazy('Submit!', 'ri.fusion.main.document...', 'submit_table', TRUE, 'time', 'key_column', A2:A10, 'value_column', B2:B10) は、A2 および B2:10 を指定したシート内のテーブル 'submit_table' の 'key_column' および 'value_column' の各行に送信します。現在のタイムスタンプが 'time' 行に送信されます。

注意：パラメーターとして、受信するスプレッドシートに表示させたい key column、value のペアを好きなだけ含めることができます。ただし、送信される順序で表示させたいすべてのパラメーターをリストにする必要があります。

引数

  • button_label： STRING
    ボタンに表示する文字列を指定します。
  • document_identifier： STRING
    送信するデータが書き込まれるデータセットの RID を挿入します。RID はドキュメントの URL で識別でき、ri.fusion.main... のように見えます。
  • region_name： STRING
    書き込むテーブル領域の名前を指定します。まだこのテーブル領域を指定していない場合は、受信するスプレッドシートに移動し、'create table region' ウィジェットを使用し、テーブルに直感的な名前を付けます。
  • should_submit： ANY
    送信シートの特定の行に対応し、真偽値（つまり true/false）を含みます。should_submit が true の場合、データが送信されます。
  • timestamp_column： STRING
    現在のタイムスタンプを送信する行のヘッダーを指定します。
  • key_column： STRING
    送信する値を格納する行のヘッダーを指定します。key_column の各値は一意でなければなりません。
  • key_value： ANY
    指定した key_column に送信する特定のセルまたはセル範囲を示します。
  • 行： STRING
  • value： ANY

submit_to_region_with_key_lazy(button_label: string, document_identifier: string, region_name: string, should_submit: any, key_column: string, key_value: any, [行: string, value: any, ...]): string

submit_to_region_with_keyと全く同じ動作をしますが、クリック時に送信する値を計算し、対象領域の情報をキャッシュします。大量の範囲を送信したり、短時間に同じ領域に複数回送信する予定がある場合に使用します。

指定されたキーで領域にデータを送信するボタンを作成します。

例: =submit_to_region_with_key_lazy('Submit!', 'ri.fusion.main.document...', 'submit_table', TRUE, 'time', 'key_column', A2:A10, 'value_column', B2:B10)は、指定されたシート内のテーブル'submit_table'の行'key_column'と'value_column'にそれぞれA2とB2:10を送信します。

注意: パラメーターには受け取り側のスプレッドシートに表示したいkey 行、valueのペアを好きなだけ含めることができます。ただし、送信される順序で表示したい全てのパラメーターをリストアップする必要があります。

引数

  • button_label: 文字列
    ボタンに表示したい文字列を指定します。
  • document_identifier: 文字列
    送信内容が書き込まれるデータセットのRIDを挿入します。RIDはドキュメントのURLで確認でき、ri.fusion.main...のようになっています。
  • region_name: 文字列
    書き込むテーブル領域の名前を指定します。まだこのテーブル領域を指定していない場合は、受け取り側のスプレッドシートに移動し、'create table region'ウィジェットを使用してテーブルに直感的な名前を付けます。
  • should_submit: ANY
    送信シートの特定の列に対応し、その列にはブール値（つまり、真/偽）が含まれています。should_submitが真であれば、データは送信されます。
  • key_column: 文字列
    送信する値を入れたい列ヘッダーを指定します。key_columnの各値は一意でなければなりません。
  • key_value: ANY
    指定されたkey_columnに送信される特定のセルまたはセル範囲を示します。
  • 行: 文字列
  • value: ANY

substring(value: number, index: number, length: number): string

valueのindex（1から始まる）からlengthの長さの部分文字列を抽出します。

例: セルA1に'cow jumped over the moon'というフレーズがあるとし、その中から'cow'という部分文字列を抽出したいとします。部分文字列はインデックス1から始まり、長さは3です。substring(A1, 1, 3)を使用すると、'cow'という文字列だけを抽出できます。

引数

  • value: 数値
  • index: 数値
  • length: 数値

subtotal(function_code: number, [range: range, ...]): number

次の引数で指定された範囲に対して、function_code（以下に説明）で指定された集計を計算します。range内に他の小計（またはネストされた小計）がある場合、これらのネストされた小計は二重計算を避けるために無視されます。

function_codeの可能なコードは以下の通りです:

  • 1 または 101: AVG
  • 2 または 102: COUNT_NUMERIC
  • 3 または 103: COUNT
  • 4 または 104: MAX
  • 5 または 105: MIN
  • 6 または 106: PRODUCT
  • 7 または 107: STDDEV
  • 8 または 108: STDDEV_P
  • 9 または 109: SUM
  • 10 または 110: VARIANCE
  • 11 または 111: VARIANCE_P

引数

  • function_code: 数値
  • range: 範囲

sum([value: number, ...]): number

グループ内の式の合計を返します。

例: sum(23,45,32)は100を返します。

引数

  • value: 数値

sum_distinct([value: number, ...]): number

式の中の重複しない数値の合計を返します（つまり、全ての重複した値は無視されます）。

例: sum_distinct(23,45,32,45)は100を返します。この関数は、重複した数値を計算しないため、2つ目の45は無視します。

引数

  • value: 数値

sum_product([value: any, ...]): number

指定されたvalueの対応する成分を乗算し、これらの積の合計を返します。各valueは同じ次元を持ち、非数値の引数は全てゼロとして扱われます。

例: sum_product(A1:A3, B1:B3)はA1B1 + A2B2 + A3*B3の合計を出力します。

引数

  • value: ANY

sumif(criteria_range: range, condition: any, sum_range: range): number

criteria_range が condition に等しい場合、sum_range のすべての値の合計を返します。

注意: criteria_range と sum_range の範囲サイズは一致している必要があります。

例: A1 には名前のリストがあり、C1 には対応する年齢が含まれているとします。A1 で名前が 'John' のすべての人の年齢を合計したい場合、sumif(A1:A50, 'John', C1:C50) を使用して合計を取得します。

引数

  • criteria_range: RANGE
  • condition: ANY
  • sum_range: RANGE

sumifs(sum_range: range, [criteria_range: range, condition: any, ...]): number

後続の引数で与えられた条件に一致する sum_range のすべての値の合計を返します。

例: sumifs(A1:B5, C1:D5, 10, H4:I8, 'John') は、A1 のすべてのセルの合計を返します。ただし、C1 の対応するセルが 10 に等しく、H4 の対応するセルが 'John' に等しい場合です。

注意: criteria_range と sum_range の範囲サイズは一致している必要があります。

引数

  • sum_range: RANGE
  • criteria_range: RANGE
  • condition: ANY

tan(value: number): number

value の正接を計算します。

例: tan(45) は 1.6197 を返します。

引数

  • value: NUMBER

timestamp(year: number, month: number, day: number, hour: number, minute: number, second: number): date_time

定義された year, month, day, hour, minute, second のタイムスタンプを yyyy-MM-dd HH:mm の形式で作成します。 年が 1900 より小さい場合（例: '97'）、年は 1900 からのオフセットとして解釈されます（例: '1997'）。

引数

  • year: NUMBER
  • month: NUMBER
  • day: NUMBER
  • hour: NUMBER
  • minute: NUMBER
  • second: NUMBER

to_unix_timestamp(date: string, [pattern: string]): number

オプションの pattern（つまり、日付形式）を持つタイムスタンプ date を、1970 年 1 月 1 日 00:00:00 GMT からのミリ秒数である Unix エポックに変換します。日付は、日付、タイムスタンプ、または文字列にすることができます。文字列を提供する場合は、解析用のパターンを含めることができます。

例: 文字列 2021-02-15 があります。日付の pattern は yyyy-MM-dd です。このタイムスタンプを変換するには、to_unix_timestamp('2021-02-15', 'yyyy-MM-dd') を使用します。

引数

  • date: STRING
  • pattern: STRING

tooltip(cell_value: any, tooltip_content: string, [open_delay: number]): any

ホバーするとツールチップが表示されるセルをレンダリングします。

tooltip_content 引数は、マークダウン形式の文字列としてフォーマットすることができます。open_delay 引数は、ツールチップがホバー後に表示されるまでの遅延を変更するために使用できます。

引数

  • cell_value: ANY
  • tooltip_content: STRING
  • open_delay: NUMBER

trim(value: string): string

value の両端のスペースをトリムします。

例: A1 に 'John Smith' という文字列があり、両端に 4 つのスペースがあるとします。trim(A1) は、スペースを取り除いた新しい文字列を作成します。

引数

  • value: STRING

upper(value: string): string

文字列全体を大文字に変換します。

例: A1 に名前 John Smith がある場合、Upper(A1) は JOHN SMITH を返します。

引数

  • value: STRING

url(url: string, [label: string]): any

オプションの label を持つ url へのハイパーリンクをレンダリングします。

例: url('myblog.com', 'My Blog') は、'My Blog' というラベルのハイパーリンクを作成します。

引数

  • url: STRING
  • label: STRING

url_encode(input: any): string

input を URL パスおよびパラメータで安全に使用できるようにエンコードします。

例: =url(concat('http://example.com/test?param=', url_encode(A5)))

引数

  • input: ANY

variance([value: number, ...]): number

グループ内の値の無偏分散を返します。

例: variance(23, 45, 32) は 122.33 を返します。

引数

  • value: NUMBER

variance_p([value: any, ...]): number

value 項目が全体の集団を構成すると仮定した場合、グループ内の値のバイアス分散を返します。

注：それらが集団の一部のサンプルを表現している場合は、代わりに VARIANCE を使用してください。

引数

  • value: ANY

vlookup(value: any, range: range, column: number): any

range の最初の列で value を検索し、column (1から始まります)を取得します。

例：列Aが果物の名前のリストで、列Cが価格のリストであるとします。vlookup(A3,A1:C6,3) は、セルA3の果物の名前を取得し、指定した範囲の列3の対応する価格を返します。

引数

  • value: ANY
  • range: RANGE
  • column: NUMBER

week_of_year(date: date_time): number

date の週の番号を整数として計算します。

例：Week_of_year('2021-06-18') は24を返します。

引数

  • date: DATE_TIME

workday(start_date: date_time, value: number, [holidays: any]): date

開始日から指定された数の営業日前後の日付を表す数を返します。営業日は週末と祝日を除きます。

例：workday('2010-01-01',10) は週末が無視されたため、2010-01-15を返します。もう一つの例：workday('2010-01-01',10, '2010-01-05') は週末と祝日が無視されたため、2010-01-18を返します。

引数

  • start_date: DATE_TIME
  • value: NUMBER
  • holidays: ANY

year(date: date_time): number

date の年を整数として抽出します。

例：セルA2にタイムスタンプ 2022-02-15 08:30:15 があるとしましょう。Year(A2) は2022を返します。

引数

  • date: DATE_TIME

アクション関数

Fusion のデフォルトのアクションライブラリメソッド。

compute_on_trigger(actionCell: any): any [EXPERIMENTAL]

トリガー時に引数として渡されたactionCell参照のアクションを遅延計算します。

これはそのセルに対する依存関係とは見なされず、いくつかのケースで循環依存関係を回避することができます。

引数

  • actionCell: ANY

copy_range(source: any, target: range, [copy_result: boolean]): string

トリガーされると、一つの範囲から別の範囲へ内容をコピーするアクション。

引数

  • source: ANY
    コピー元のセル範囲。ターゲットを空にしたい場合は NULL にできます。
  • target: RANGE
  • copy_result: BOOLEAN
    true の場合、計算されたセルの値をコピーします。false または省略された場合、セルの式をコピーします。

dropdown(values: array, [selected_value: string], [actionBeforeChange: any], [allow_invalid: boolean], [placeholder_text: string]): any [EXPERIMENTAL]

提供された values 配列から選択可能な値を持つドロップダウンをレンダリングします。values は一意でなければならず、各値はドロップダウンの文字列ラベルに変換されます。

この関数は action.serial や action.parallel の中にネストできません。

例：=action.dropdown(array('red', 'blue', 'green')) は 'red', 'blue', 'green' の値を持つドロップダウンを作成します。

actionBeforeChange が提供された場合、ドロップダウンの新しく選択された値が保存され、他の式によって考慮される前に実行されるアクションを指定します。

selected_value が提供された場合、それはドロップダウンのデフォルトの文字列ラベルを指定します。selected_value はオプションで、nullに設定することができ、これによりドロップダウンの選択は未選択の状態になります。selected_value が設定されていて、選択されたラベルが values 配列に見つからない場合 (基礎となるデータが変更された場合など)、結果は空のセルになります。

allow_invalid が true に設定されている場合、この動作は上書きされ、以前に保存された選択を出力します。この結果は文字列だけであり、文字列の値の一部から前回の選択を保存しようとする場合にのみ推奨されます。

placeholder_text は、値が選択されていないときにドロップダウンにテキストを表示することができます (プロンプトや指示として便利です)

引数

  • values: ARRAY
  • selected_value: STRING
  • actionBeforeChange: ANY
  • allow_invalid: BOOLEAN
  • placeholder_text: STRING

fail(): any

操作が失敗したアクション。シリアルの中でショートサーキットするために組み合わせることができます。

label(type: string, label: string, [icon: string], [intent: string]): string

ラベルをレンダリングします。タイプは 'button', 'link', 'tag' のいずれかになります。

例：action.label('button', 'Submit', 'tick', 'success') は、チェックマークと「Submit」という言葉が入った緑色のボタンをレンダリングします。

引数

  • type: STRING
  • label: STRING
  • icon: STRING
    Blueprint documentationでアイコンのリストを見ることができます。
  • intent: STRING
    intent はラベルの色を定義します：'primary' は青、'success' は緑、'warning' はオレンジ、'danger' は赤を意味します。Blueprint documentationでintentとその出力の完全なリストを見ることができます。

open_markdown_panel(panel_title: string, markdown_content: string): string

提供されたタイトルとマークダウン文字列を使用して、コンテクストに基づくサイドパネルを開きます。

マークダウンにCSSスタイルを使用している場合、.fusion-markdown-panel クラスでそれをスコープすることができます。

引数

  • panel_title: STRING
  • markdown_content: STRING

open_url(url: string, [redirect: boolean]): string

URLを開きます。デフォルトでは新しいタブで開き、既存のスプレッドシートページにリダイレクトしたい場合は、 redirect パラメーターをtrueに設定します。

引数

  • url: STRING
  • redirect: BOOLEAN

parallel([action: any, ...]): string

アクションのリストが与えられた場合、それらをすべて同時にトリガーします。

  • action: ANY

plugin(action_name: string, [arg: any, ...]): any

このサーバーにデプロイされたカスタムアクションを実行します。利用可能なアクションのリストを取得するために、Palantirの担当者に連絡してください。

引数

  • action_name: STRING
  • arg: ANY

serial(action: any, actionOnSuccess: any, [actionOnFailure: any]): string

前のアクションの成功（または失敗）のみに発生すべきアクションを定義します。

引数

  • action: ANY
  • actionOnSuccess: ANY
  • actionOnFailure: ANY

submit_options([key: string, value: any, ...]): options [EXPERIMENTAL]

action.submit_to_region_with_options(...) のための設定可能なキー-値オプション。

利用可能なオプション：

  • submitEmptyCells: 空またはnullのセルは、目的地のテーブルでこの行に存在するデータを上書きします
  • succeedWhenNoRows: shouldSubmitが偽またはすべての行で偽の場合、アクションの振る舞いを変更して成功するようにし、トーストを表示するのではなく失敗するようにします

引数

  • key: STRING
  • value: ANY

submit_to_region(document_identifier: string, region_name: string, should_submit: any, timestamp_column: string, key_column: string, key_value: any, [column: string, value: any, ...]): string

指定したキーを持つリージョンにデータを送信するボタンを作成します。

例：=action.submit_to_region('ri.fusion.main.document...', 'submit_table', TRUE, 'time', 'first_column', A1:A10, 'second_column', B1:B10) は、A1とB1:10をそれぞれ 'first_column'と'second_column'の行に送信し、指定されたシート内の 'submit_table'テーブルに送信します。現在のタイムスタンプは'time'行に送信されます。

引数

  • document_identifier: STRING
    提出物が書き込まれるデータセットのRIDを挿入します。RIDはドキュメントのURLで識別でき、ri.fusion.main...のように見えます。document_metadata('document_identifier')を使用して、現在のシートのRIDを参照できます。

  • region_name: STRING
    書き込みを行うテーブルリージョンの名前を指定します。まだこのテーブルリージョンを指定していない場合は、受信スプレッドシートに移動し、'create table region'ウィジェットを使用し、テーブルに直感的な名前を付けてください。

  • should_submit: ANY
    提出シート内の特定の行に対応します。それがブール値（すなわち真/偽）を含んでいます。 should_submitが真であれば、データが送信されます。

  • timestamp_column: STRING
    現在のタイムスタンプを送信したい行ヘッダーを指定します。タイムスタンプが不要な場合はnullを使用します。

  • key_column: STRING
    値を送信したい行ヘッダーを指定します。

  • key_value: ANY
    指定した key_columnに送信される特定のセルまたはセル範囲を示します。

  • column: STRING

  • value: ANY

submit_to_region_with_options(document_identifier: string, region_name: string, submit_options: options, should_submit: any, timestamp_column: string, key_column: string, key_value: any, [column: string, value: any, ...]): string [EXPERIMENTAL]

指定したキーでリージョンにデータを送信するボタンを作成します。

例：=action.submit_to_region_with_options('ri.fusion.main.document...', 'submit_table', TRUE, 'time', 'first_column', A1:A10, 'second_column', B1:B10) は、A1とB1:10をそれぞれ 'first_column'と'second_column'の行に送信し、指定されたシート内の 'submit_table'テーブルに送信します。現在のタイムスタンプは'time'行に送信されます。

引数

  • document_identifier: STRING
    提出物が書き込まれるデータセットのRIDを挿入します。RIDはドキュメントのURLで識別でき、ri.fusion.main...のように見えます。document_metadata('document_identifier')を使用して、現在のシートのRIDを参照できます。
  • region_name: STRING
    書き込みを行うテーブルリージョンの名前を指定します。まだこのテーブルリージョンを指定していない場合は、受信スプレッドシートに移動し、'create table region'ウィジェットを使用し、テーブルに直感的な名前を付けてください。
  • submit_options: OPTIONS
    action.submit_options(...) で送信アクションに使用する設定可能なオプションを指定します。submit_options 関数ドキュメンテーションの可能な値
  • should_submit: ANY
    提出シート内の特定の行に対応します。それがブール値（すなわち真/偽）を含んでいます。 should_submitが真であれば、データが送信されます。
  • timestamp_column: STRING
    現在のタイムスタンプを送信したい行ヘッダーを指定します。タイムスタンプが不要な場合はnullを使用します。
  • key_column: STRING
    値を送信したい行ヘッダーを指定します。
  • key_value: ANY
    指定した key_columnに送信される特定のセルまたはセル範囲を示します。
  • column: STRING
  • value: ANY

success(): any

成功したアクションの無操作。シリアルで短絡の組み合わせに使用できます。

toast(message: string, [intent: string], [dismissButton: string]): string

トーストをトリガーします。ding!。

dismissButtonが定義されている場合、トーストはユーザーが解散ボタンをクリックするまで続きます。トーストが action_serial 関数でラップされている場合、次のアクションがトリガーされます。

引数

  • message: STRING
  • intent: STRING
  • dismissButton: STRING

trigger(label: any, action: any): string

ラベルとアクションが指定された場合、ラベルがクリックされたときにアクションをトリガーします。

action_label 関数でラベルを設定します。

引数

  • label: ANY
  • action: ANY

validate_table(table_range: range, [condition: any, ...]): string

範囲と条件のリストが与えられた場合、すべての条件が満たされていることを検証します。

引数

  • table_range: RANGE
  • condition: ANY

検証関数

Fusion のデフォルトの検証ライブラリメソッド。

column_enum(column_name: string, allowed_values: array): string

行名と許可された値のリストが与えられた場合、その行のすべての非 null 値が許可されたリストにあることを検証します。

引数

  • column_name: STRING
  • allowed_values: ARRAY

column_not_null([column_name: string, ...]): string

行名のリストが与えられた場合、非空の行に対してそれらが空でないことを検証します。 つまり、これらの列は、行全体が空の場合にのみ空にできます。

引数

  • column_name: STRING

column_numeric([column_name: string, ...]): string

行名のリストが与えられた場合、各行に数値のみが含まれていることを検証します。

引数

  • column_name: STRING

column_regex(column_name: string, regex: string): string

行名と正規表現文字列が与えられた場合、その行のすべての値が指定された正規表現に一致することを検証します。

引数

  • column_name: STRING
  • regex: STRING

table_headers([column_name: string, ...]): string

行名のリストが与えられた場合、それらが定義されたテーブルに存在することを検証します。

引数

  • column_name: STRING

table_key([column_name: string, ...]): string

行名のリストが与えられた場合、それらの組み合わせがテーブル内で一意であることを検証します。 例: 最初の行にこれらの2つの列名が含まれる範囲が与えられた場合：名前と年齢：2つのレコードがある場合：[Bob、20] と [Bobby、20] なら、table_key('Name', 'Age') は成功するはずです。 ただし、2つのレコードが：[Bob、20] と [Bob、20] の場合、table_key('Name', 'Age') は失敗するはずです。

引数

  • column_name: STRING

チャート関数

データをプロットするためのメソッド。

bar(x_values: any, y_values: any, [options: any, ...]): barplot

棒グラフに xy 値の一連のデータをプロットします

利用可能なオプション：

  • drawLabels: boolean
  • orientation: "horizontal" | "vertical"

引数

  • x_values: ANY
  • y_values: ANY
  • options: ANY

chart([Plots-or-options: any, ...]): chart

複数の系列をオプションで設定可能なチャートにプロットします

利用可能なオプション：

  • showAxes: boolean
  • showLegend: boolean
  • showResetZoomButton: boolean
  • showToolbar: boolean
  • tooltip: false | "closest" | "aggregate"
  • yAxisInset: boolean
  • rangeSelection: "select" | "visual" | false
  • height: number (px)
  • width: number (px)
  • Plots-or-options: ANY

line(x_values: any, y_values: any, [options: any, ...]): lineplot

折れ線グラフに xy 値の一連のデータをプロットします 利用可能なオプション：

  • dataMarkers: boolean
  • color: string

引数

  • x_values: ANY
  • y_values: ANY
  • options: ANY

options([key: string, value: any, ...]): options

設定可能なキーバリューオプションチャート。

引数

  • key: 文字列
  • value: ANY

時系列関数

時系列データを扱うためのメソッド。

count(timeSeries: any): number

シリーズ内の点の数を返します。

引数

  • timeSeries: ANY

derivative(timeSeries: any): any

時系列データの導関数（秒に対して）を取ります。

引数

  • timeSeries: ANY

difference(timeSeries: any): number

シリーズ内の最初の値と最後の値の差を返します。

引数

  • timeSeries: ANY

first_timestamp(timeSeries: any): time

時系列データの最初の点のタイムスタンプを返します。

引数

  • timeSeries: ANY

first_value(timeSeries: any): any

時系列データの最初の点の値を返します。

引数

  • timeSeries: ANY

integral(timeSeries: any, method: string): any

子シリーズの各点に対して、その点までのシリーズ下の総面積を出力します。

3つの異なる積分法がサポートされています。linear は台形則による積分近似を使用し、lhs/lhr はそれぞれ左リーマン和と右リーマン和を使用します。

引数

  • timeSeries: ANY
  • method: 文字列

last(timeSeries: any, timeAmount: number, timeUnit: string): any

指定された期間の最後の部分だけを残して時系列データをフィルター処理します。

サポートされる単位:

  • 時間/h
  • 分/m
  • 秒/s
  • マイクロ秒/us
  • ナノ秒/ns

引数

  • timeSeries: ANY
  • timeAmount: 数値
  • timeUnit: 文字列

last_timestamp(timeSeries: any): time

時系列データの最後の点のタイムスタンプを返します。

引数

  • timeSeries: ANY

last_value(timeSeries: any): any

時系列データの最後の点の値を返します。

引数

  • timeSeries: ANY

max(timeSeries: any): number

時系列データ全体での最大値を返します。

引数

  • timeSeries: ANY

mean(timeSeries: any): number

時系列データ全体での平均値を返します。

引数

  • timeSeries: ANY

min(timeSeries: any): number

時系列データ全体での最小値を返します。

引数

  • timeSeries: ANY

scale(timeSeries: any, scale: number): any

それぞれのティックを指定された係数で乗算します。

つまり、ソースの時系列データにティック (t, v) が含まれている場合、スケーリング係数 x によって、結果として得られるスケーリングされた時系列データには、ティック (t, v * x) が含まれます。

引数

  • timeSeries: ANY
  • scale: NUMBER

shift(timeSeries: any, shift: number): any

時系列データの各点を、指定された量だけシフトします。

つまり、ソースの時系列データにティック (t, v) が含まれている場合、x だけシフトさせると、結果として得られる値がシフトされた時系列データには、ティック (t, v + x) が含まれます。

引数

  • timeSeries: ANY
  • shift: NUMBER

stddev(timeSeries: any): number

時系列データ全体の標準偏差を返します。

引数

  • timeSeries: ANY

time_range(timeSeries: any, startTime: any, endTime: any): any

時系列データの特定の時間範囲を選択します。

引数

  • timeSeries: ANY
  • startTime: ANY
  • endTime: ANY

timeseries(seriesId: string): any

指定されたIDの時系列データを返します。

引数

  • seriesId: STRING

eq(value: any): same_as_first_argument

現在の value を等価性 (==) の比較としてマークします。

検索動作を変更するために、ルックアップ関数の引数に適用します。

引数

  • value: ANY

exact(value: any): same_as_first_argument

value に修飾子をタグ付けして、検索やルックアップが value の正確な一致を求めるようにする結果を返します。

引数

  • value: ANY

exp(value: number): number

value の指数に上げた e を返します。定数 e は 2.718で、自然対数の基底です。

例えば: exp(2) は 7.389 を返します。これは、自然対数 e を 2 の指数に上げた結果です。

引数

  • value: NUMBER

experimental_add_tags(value: any, tags: array): same_as_first_argument [EXPERIMENTAL]

value に tags を追加し、新たにタグ付けされた値を返します。

引数

  • value: ANY
  • tags: ARRAY

experimental_copy_and_sync_button(label: string, folder: string, name: string, [exports: array], [onCompleteMessage: string], [onFailureMessage: string], [redirectToHomeAfterCompletion: boolean]): same_as_first_argument [EXPERIMENTAL]

クリックすると、スプレッドシートを folder にコピーし、その名前を name に設定するボタンを、ラベル label でレンダリングします。

エクスポートは次のパターンを使用してコピーされます: ' $name - Export $sheetName'。 exports で望ましいエクスポートのシート名を渡すことで、エクスポートを制約することができます。エクスポートが欠落している場合、コピーは失敗します。 onCompleteMessage と onFailureMessage で、それぞれ完了メッセージと失敗メッセージを渡すことができます。 redirectToHomeAfterCompletion が true に設定されている場合、ユーザーは完了後に自分のホームフォルダーにリダイレクトされます。

引数

  • label: STRING
  • folder: STRING
  • name: STRING
  • exports: ARRAY
  • onCompleteMessage: STRING
  • onFailureMessage: STRING
  • redirectToHomeAfterCompletion: BOOLEAN

experimental_error([value: string, ...]): any [EXPERIMENTAL]

エラーを出力します。

引数

  • value: STRING

experimental_get_tags(value: any): array [EXPERIMENTAL]

value に関連付けられたタグの配列を返します。

引数

  • value: ANY

experimental_io_blocking_function([extra_delay: number]): string [EXPERIMENTAL]

タイムアウトするまで I/O をブロックするテストメソッド。オプションで、タイムアウト後に待つ追加の遅延を与えることができ、これにより I/O 関数の振る舞いが悪いことをシミュレートできます。

引数

  • extra_delay: NUMBER

experimental_range(width: number, [value: any, ...]): range [EXPERIMENTAL]

範囲を出力します。

引数

  • width: NUMBER
  • value: ANY

experimental_remove_tags(value: any, [tags: array]): same_as_first_argument [EXPERIMENTAL]

tags 配列のタグを value から削除し、または tags 引数が存在しない場合は value からすべてのタグを削除します。

引数

  • value: ANY
  • tags: ARRAY

factorial(value: number): number

与えられた value の階乗を計算します。

例えば: factorial(3) は 6 を返します。

引数

  • value: NUMBER

find(search_for: string, text_to_search: string, [starting_index: number]): number

文字列 text_to_search の中で search_for の最初のインスタンスのインデックスを返します。検索の starting_index をオプションで提供することができます。

例えば: セル A1 に 'The grey cat chased the grey mouse' というフレーズがあるとします。'grey' の最初のインスタンスのインデックスを確認するためには、 find('grey', A1) を実装してインデックス 5 を取得します。

引数

  • search_for: STRING
  • text_to_search: STRING
  • starting_index: NUMBER

floor(value: number): number

与えられた value の床を計算し、最も近い小数点以下のない数値に切り捨てます。

例えば: floor(3.2) は 3 に丸められます。また、 floor (-4.5) は -5 に丸められます。

引数

  • value: NUMBER

format_number(value: number, decimalPlaces: number): number

数値のセル value を #,###.## のような形式にフォーマットし、 decimalPlaces で指定された小数点以下の桁数に丸めます。結果は文字列として返されます。

例えば：行 A に 4 桁の数字があるとしましょう。そして、千の区切りと 2 桁の小数点を含めたいと思います。最初の数字を #,###.00 に再フォーマットするには format_number(A1, 2) を使用します。ボックスを下にドラッグして行 A の残りに適用します。

引数

  • value: NUMBER
  • decimalPlaces: NUMBER

format_string([format: string, ...]): number

arg を printf スタイルでフォーマットし、結果を format を使用して文字列属性として返します。

引数

  • format: STRING

fuzzy(value: any, [distance: number]): same_as_first_argument

検索とルックアップが、検索された値が実際の値から distance エディット以内であるように、ファジーな方法で行われるように、修飾子が付いた value を返します。0、1、2 のエディット距離のみがサポートされ、デフォルトは 2 です。

距離は、一つの文字列から別の文字列へ移行するために必要な単一文字編集の数を測定する、レーベンシュタイン距離に対応します。

引数

  • value: ANY
  • distance: NUMBER

get_object_rid(object_or_property: any): string

指定されたオブジェクトまたはオブジェクトプロパティのオブジェクト RID を返します。

引数

  • object_or_property: ANY

get_object_type_id(object_or_property: any): string

指定されたオブジェクトまたはオブジェクトプロパティのオブジェクトタイプ id を返します。

引数

  • object_or_property: ANY

get_property(object: object, key: string): object

オブジェクトの指定されたプロパティを返します。

引数

  • object: OBJECT
  • key: STRING

gt(value: any): same_as_first_argument

現在の value を大なり (>) 比較としてマークします。

ルックアップ関数の引数に適用して検索動作を変更します。

引数

  • value: ANY

gte(value: any): same_as_first_argument

現在の value を大なりイコール (>=) 比較としてマークします。

ルックアップ関数の引数に適用して検索動作を変更します。

引数

  • value: ANY

hlookup(value: any, range: range, row: number): any

range の最初の行で value をルックアップし、 row を取得します（1 から始まります）。

例えば：行 A が色のリストだとしましょう。 hlookup(A1,A1:A100,5) はその行の 5 番目の色を返します。

引数

  • value: ANY
  • range: RANGE
  • row: NUMBER

hour(date: date_time): number

指定された日付/タイムスタンプ/文字列から時間を整数として抽出します。この関数は、文字列内の日付と分を無視します。

例えば：セル A2 にタイムスタンプ 2021-02-15 08:30:15 があるとします。 hour(A2) は 8 を返します。

引数

  • date: DATE_TIME

if(condition: boolean, value_if_true: any, value_if_false: any): any

condition が真と評価された場合、 value_if_true で指定された値を返します。 condition が偽と評価された場合、 value_if_false で指定された値を返します。

例えば： if(A1 >=5, 'True', 'False') の関数を実装しましょう。A1 が 6 であれば、関数は True を返します。A1 が 4 であれば、関数は False を返します。

引数

  • condition: BOOLEAN
  • value_if_true: ANY
  • value_if_false: ANY

iferror(value: any, value_if_error: any): any

エラーが検出されない場合、 value を返します。それ以外の場合、 value_if_error によって指定されたエラーをスローします。この関数は、エラーメッセージの管理によりエレガントな解決策を提供します。

例えば：セル C3 に簡単な式 A1/B2 があるとします。B2 が空白であれば、式が 'B2 に値を入力してください.' というエラーをスローするようにしたいとします。 iferror(A1/B2, 'B2 に値を入力してください.') を実装します。

引数

  • value: ANY
  • value_if_error: ANY

index(range: range, row_offset: number, column_offset: number): any

range 内のセルの内容を返します。セルは row_offset と column_offset によって指定されます。 row_offset はデータを取得したい行を指定し、 column_offset はデータを取得したい行を指定します。

例えば： index(A1:C6, 2, 3) は、範囲 A1 から行 2、列 3 のデータを取得したいことを意味します。

注：行オフセットが0に設定されている場合、 column_offset で指定された全列が選択されます。列オフセットが0の場合、 row_offset で指定された全行が選択されます。両方がゼロの場合、全セル範囲が選択されます。

引数

  • range: RANGE
  • row_offset: NUMBER
  • column_offset: NUMBER

internal_region_result(region_id: string): any [EXPERIMENTAL]

内部関数。

引数

  • region_id: STRING

isNull(value: any): boolean

属性が null または空のセルの場合、関数は true を返します。それ以外の場合、関数は false を返します。

例えば：列 A が整数と null 値の混在しているとしましょう。 isnull(A1) を使用して、列の最初の値が true（つまり、null 値）か整数かを判断します。この式を下にドラッグして、列の残りに適用します。

引数

  • value: ANY

last_day(date: date_time): number

date 属性を指定すると、関数は指定した月の最終日を yyyy-MM-dd 形式で返します。注：日付は文字列として入力する必要があります。

例えば：現在の日付が 2021-02-01 で、その月の最終日を計算したいとします。 last_day('2021-02-01') を使用して 2021-02-28 を取得します。注：1月の日付は常に31を返し、2月の日付は年により28または29を返します。

引数

  • date: DATE_TIME

left(text: string, [num_chars: number]): string

文字列 text の開始から num_chars で指定された文字数を返します。

例えば：文字列 'John Smith' がセル A2 にある場合、 right(A2, 3) は ith を返します。

引数

  • text: STRING
  • num_chars: NUMBER

length(value: any): number

指定された文字列またはバイナリ属性の長さを、文字数に基づいて計算します。

例えば： length('John Smith') は10を返します。

引数

  • value: ANY

ln(value: number): number

指定された値の自然対数を計算します。値が0以下の場合、関数はエラーを返します。

例えば： ln(7) は1.9459を返します。

引数

  • value: NUMBER

log(value: number, base: number): number

base で指定された基数を持つ value の対数を計算します。

例えば： log(8,2) は3を返します。

引数

  • value: NUMBER
  • base: NUMBER

lookup(dataset_path: string, result_column: string, [column: string, value: string, ...]): any

dataset_path の result_column から、 column、 value のペアで定義されたフィルターに一致する値を返します。

例えば： lookup('/Users/me/myData', 'my_column', 'first_name', 'John', 'last_name', 'Doe') は、データセット '/Users/me/myData' を検索し、first_name = 'John' および last_name = 'Doe' の行を探し、フィルターに一致する my_column の値を取得します。

注：

  • Value は exact または fuzzy 関数でラップすることで、一致が完全であるかあいまいであるかを指定できます。 Dataset_path は branch 関数でラップすることで、データセットのブランチを指定できます。
  • 新しくインデックスされたデータセットが見つからない場合は、ページを再読み込みするか、Find and use data に移動し、Indexed datasets を選択し、再読み込みボタンを選択します。

引数

  • dataset_path: STRING
  • result_column: STRING
  • column: STRING
  • value: STRING

lookup_array(dataset_path: string, result_column: string, [column: string, value: string, ...]): any

dataset_path の result_column から、行のグローバルな順序に基づいてソートされた配列として一致する値を返します。結果は column、 value のペアで定義された後続の引数を使用してフィルター処理されます。

例えば： lookup('/Users/me/myData', 'my_column', 'first_name', 'John', 'last_name', 'Doe') は、 '/Users/me/myData' のデータセットを検索し、first_name = 'John' および last_name = 'Doe' の行を探し、一致する行の my_column の値を取得します。

注：

  • Value は exact または fuzzy 関数でラップすることで、一致が完全であるかあいまいであるかを指定できます。
  • 新しくインデックスされたデータセットが見つからない場合は、ページを再読み込みするか、Find and use data に移動し、Indexed datasets を選択し、再読み込みボタンを選択します。

引数

  • dataset_path: STRING
  • result_column: STRING
  • column: STRING
  • value: STRING