注: 以下の翻訳の正確性は検証されていません。AIPを利用して英語版の原文から機械的に翻訳されたものです。
これらの関数は Fusion のデフォルトのメソッドです。
数値の絶対値(符号を除いた数値)を計算します。
たとえば、abs(-2) は値2を返します。
変数
value: NUMBER数値の逆余弦を返します。逆余弦は、余弦がその数値になる角度です。返される角度は、0から Π の範囲のラジアンで表されます。
たとえば、acos(1) は値0を返します。
変数
value: NUMBERトークン単位で検索と参照を実行できる修飾子をタグとして付けた value を返します。この検索と参照では、すべての語句が結果のどこかに含まれます。
変数
value: ANYトークン単位で検索と参照を実行できる修飾子をタグとして付けた value を返します。この検索と参照では、1つ以上の語句が結果のどこかに含まれます。
変数
value: ANY入力されたすべての属性から配列を作成します。作成された配列は [角括弧] で囲まれます。すべての属性が1つのセルに列挙されます。
たとえば、array('John', 'Mary', 'Richard') は配列 [ John, Mary, Richard ] を作成します。
注:属性が文字列の場合は、'シングルクォート' で囲む必要があります。
変数
arg: ANY入力されたすべての配列を1つの配列に連結します。
たとえば、セル A1 に配列 [1,2,3] があり、セル A2 に配列 [4,5,6] があるとします。Array_concat(A1,A2) は新しい配列 [1,2,3,4,5,6] を返します。
変数
array: ARRAYarray に value が含まれているかどうかを確認します。配列にその値が含まれている場合、この関数は true を返します。
たとえば、セル E7 に配列 [ John, Mary, Richard ] がある場合、array_contains(E7, 'Richard') を実行すると、配列内に値 'Richard' があるかどうかを確認します。この場合、関数は True を返します。array_contains(E7, 'Louise') を入力すると、関数は False を返します。
変数
array: ARRAYvalue: ANY最初の配列に含まれ、ほかのどの配列にも含まれない一意の要素をすべて返します。順序は保証されません。
たとえば、セル E7 に配列 [ John, Mary, Richard, Richard ] があり、セル E8 に配列 [ John, Mary, Bob] がある場合、array_difference(E7, E8) は [ Richard ] を返します。
変数
array: ARRAYdifferenceArrays: ARRAY入力引数の一意の値のみを含む配列を返します。
たとえば、array_distinct(array(3, 2, 1), 4, array(1, 2)) は array(3, 1, 4, 2) を返します。
注:値の順序は保持されません。また、値に付いているタグ(あいまい一致や完全一致など)はすべて削除されます。
変数
value: ANY入力されたすべての属性から配列を作成します。作成された配列は [角括弧] で囲まれます。すべての属性が1つのセルに列挙されます。
この関数は array と似ていますが、セル範囲と配列を平坦化し、行ごとに左から右へ値を取り込みます。範囲内の空の値とエラーは無視されます。
たとえば、A1 = array('Zoe', 'Charles')、A2 = 'Mary'、B2 = 'Richard' の場合、array_flatten('John', A1:B2) は配列 [ John, Zoe, Charles, Mary, Richard ] を作成します。セル A1 の配列が平坦化されて出力に含まれ、空のセル B1 はスキップされることに注意してください。
注:属性が文字列の場合は、'シングルクォート' で囲む必要があります。
変数
arg: ANY指定された array の位置 index(1始まりのインデックス)にある要素を返します。
たとえば、セル E7 に配列 [ John, Mary, Richard ] があり、3番目の位置にある属性を確認するには、array_get_at_index(E7, 3) を使用できます。これは、配列の3番目の属性である Richard を返します。
変数
array: ARRAYindex: NUMBERarray の最初の要素を取得します。
変数
array: ARRAYarray の最後の要素を取得します。
変数
array: ARRAY指定されたすべての配列に含まれる一意の要素をすべて返します。順序は保証されません。
たとえば、セル E7 に配列 [ John, Mary, Mary, Richard ] があり、セル E8 に配列 [ John, Mary, John, Bob] がある場合、array_intersection(E7, E8) は [ John, Mary ] を返します。
変数
array: ARRAYintersectionArrays: ARRAY指定された配列の長さを返します。
たとえば、セル E7 に配列 [ John, Mary, Richard ] があり、配列の長さを確認するには、array_length(E7) と入力します。配列には3個の属性があるため、関数は値3を返します。
変数
array: ARRAYarray の start_index(この値を含む)から end_index(この値を含む)までを切り出し、配列を返します。
たとえば、セル E7 に配列 [ John, Mary, Richard ] がある場合、array_slice(E7, 1, 2) は [ John, Mary ] を返します。
start_index が0、または配列の長さより大きい場合、空の配列が返されます。例:array_slice(E7, 5, 2) → []。start_index が負の場合、配列の末尾からのオフセットとして使用されます。例:array_slice(E7, -2, 2) → [ Mary ]。end_index が0、または配列の長さより大きい場合、配列の末尾までの部分配列が抽出されます。例:array_slice(E7, 2, 5) → [ Mary, Richard ]。end_index が負の場合、配列の末尾からのオフセットとして使用されます。例:array_slice(E7, 1, -2) → [ John, Mary ]。
変数
array: ARRAYstart_index: NUMBERend_index: NUMBER指定された配列を昇順に並べ替えて返します。降順に並べ替えるには、第2パラメーターに FALSE または 'DESC' を指定できます。
たとえば、セル E7 に配列 [ 3, 4, 1 ] があり、配列を並べ替えるには、array_sort(E7, 'DESC') と入力します。関数は配列 [ 4, 3, 1 ] を返します。
変数
array: ARRAYsort_direction: ANY要素をグループ化した配列を作成します。最初のグループには指定された配列の最初の要素が、2番目のグループには指定された配列の2番目の要素が含まれ、以降も同様に続きます。作成された配列の長さは、最も短い入力配列の長さと等しくなります。
たとえば、セル A1 に配列 ['a', 'b', 'c'] があり、セル A2 に配列 [1, 2, 3] がある場合、array_zip(A1, A2) は新しい配列 [ [ 'a', '1' ], [ 'b', '2' ], [ 'c', '3' ] ] を返します。
変数
array: ARRAY数値の逆正弦を返します。逆正弦は、正弦がその数値になる角度です。返される角度は、-Π/2から Π/2 の範囲のラジアンで表されます。
たとえば、asin(-1) は値 -Π/2 を返します。
変数
value: NUMBER数値の逆正接を返します。逆正接は、正接がその数値になる角度です。返される角度は、-Π/2から Π/2 の範囲のラジアンで表されます。
たとえば、atan(0) は値0を返します。
変数
value: NUMBER指定された x 座標と y 座標のアークタンジェント(逆正接)を返します。アークタンジェントは、x 軸から、原点 (0, 0) と座標 (x_num, y_num) の点を通る直線までの角度です。角度は -Π を除く -Π から Π までの範囲で、ラジアン単位で表されます。
例:atan2(1,1) は値 0.785398163 を返します。
変数
x_num: NUMBERy_num: NUMBER指定された range の数値の平均を計算します。この範囲は、値の集合または値の範囲として入力できます。
例:avg(5, 7, 11) は 7.66 を返します。
変数
range: RANGE数値からバイナリオブジェクトを作成します。各数値は符号なしバイト (0-255) として扱われます。上位ビットは無視されます。
例:binary(0, 0, 127)。
変数
value: ANYbranch_name でタグ付けされた dataset_path を返します。検索で使用するブランチを指定するには、参照の最初の引数に適用します。
注:新しくインデックス化されたデータセットが見つからない場合は、ページを再読み込みするか、データを探して使用するに移動してインデックス化されたデータセットを選択し、再読み込みボタンを選択します。
変数
dataset_path: STRINGbranch_name: STRING大文字を小文字に、小文字を大文字に変更します。数値は変更されません。
変数
value: STRING指定された value の立方根を計算します。
例:cbrt(8) は 2 を返します。
変数
value: NUMBER指定された value を小数部分のない最も近い数値に切り上げて、天井値を計算します。
例:Ceil(5.2) は 6 を返します。
変数
value: NUMBERチェックされている場合に true を返し、それ以外の場合に false を返すチェックボックスを表示します。ラベルは任意です。checked 引数が指定されていない場合、デフォルトは false で、チェックされていない状態です。
変数
checked: BOOLEANlabel: STRINGnull ではない最初の属性を返します。すべての属性が null の場合は、null を返します。
例:列 A に名前と null 値が混在しているとします。coalesce(columnA) を使用すると、関数は最初の利用可能な名前を返します。
変数
arg: ANY指定された文字色と背景色でセルを表示します。
変数
cell_value: ANYtext_color: STRINGbackground_color: STRING複数の入力文字列属性を連結して、1つの文字列属性にします。
例:名の John がセル A2 に、姓の Smith がセル B2 にあるとします。concat 関数を使用して C2 に concat(A2, ' ', B2) と入力すると、文字列 'John Smith' が得られます。
コレクション型の引数はすべて再帰的にフラット化されます。
たとえば、concat(array(1, 2), array(array(3, 4, 5)), 6) は文字列 '123456' を返します。
arg: STRINGすべての引数の間に separator を挿入し、複数の入力文字列属性を連結して、1つの文字列属性にします。コレクション型の引数はすべて再帰的にフラット化されます。
例:名の John がセル A2 に、姓の Smith がセル B2 にあるとします。concat_ws 関数を使用して C2 に concat_ws('_',A2, B2) と入力すると、結果「John_Smith」が得られます。
コレクション型の引数は、concat 関数と同様に、すべて再帰的にフラット化されます。
変数
separator: STRINGarg: STRING指定された value の余弦を計算します。
例:cos(190) は 0.066 を返します。
変数
value: NUMBERグループ内の項目の件数を返します。
例:特定の列に含まれるオブジェクトの件数を知りたいとします。count 関数を選択して列をハイライトすると、値を取得できます。
変数
range: RANGEグループ内の重複しない項目の件数を返します。
例:count_distinct(columnA) は、この列に含まれる重複しないオブジェクトの件数を返します。この関数は配列にも適用でき、その配列に含まれる重複しないオブジェクトの件数を返します。
変数
range: RANGEグループ内の数値項目の件数を数えます。
例:さまざまな名前と数値を含む100行があるとします。この列に含まれる数値項目だけの件数を調べるには、count_numeric(A1:A100) を使用して値を取得します。
変数
value: ANY範囲 range 内で、指定された criteria と等しい項目の件数を返します。
例:列 A に動物のリストがあり、最初の100行に「Dog」が何回記載されているかを知りたいとします。countif(A1:A100, 'Dog') を使用すると、その件数が得られます。
変数
range: RANGEcriteria: ANYすべての range と criteria のペアについて、範囲 range 内で criteria と等しい項目の件数を返します。
例:countifs(A1:A100, 'Red', B1:B100, 2) は、列 A に値 Red を含み、列 B に数値 2 を含むすべての値の件数を返します。
変数
range: RANGEcriteria: ANY指定された year、month、day で、yyyy-MM-dd 形式の日付を作成します。
年が 1900 未満の日付(例:'97')では、年は 1900 からのオフセットとして解釈されます(例:'1997')。
変数
year: NUMBERmonth: NUMBERday: NUMBERdateOrDaysLeft に 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: ANYdateOrDaysRight: ANYstart から end までの日数を返します。日付は yyyy-MM-dd 形式である必要があります。
例:2021-01-15 と 2021-06-15 の間の日数を知りたいとします。2021-01-15 はセル B2 に、2021-06-15 はセル B5 にあります。date_diff (B2, B5) を使用すると、日数の差は -151日になります。
変数
start: DATE_TIMEend: DATE_TIME日付またはタイムスタンプ date を、format の文字列で指定された形式の文字列に変換します。形式には、文字列 yyyy-MM-dd のバリエーションを使用できます。
例:date_format('2021-05-06', 'MM-dd-yy') を使用して、日付 2021-05-06 の形式を 05-06-21 に変更します。
変数
date: DATE_TIMEformat: STRINGdateOrDaysLeft から dateOfDaysRight を引いた結果の日付またはタイムスタンプを返します。各パラメーターには、日数、1日未満の端数を含む日数、または日付を指定できます。日付は 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 にある2つの日付の差を日数で知りたい場合は、date_sub(D1, D2) を使います。
変数
dateOrDaysLeft: ANYdateOfDaysRight: ANY選択された日付を持つ日付ピッカーを返します。日付は yyyy-MM-dd 形式である必要があり、任意で HH:mm(時刻情報)を追加できます。時刻の精度は 'NONE'、'MINUTE'、'SECOND' のいずれかである必要があります。
変数
selectedDateTime: DATE_TIMEtimePrecision: STRING指定された日付、タイムスタンプ、文字列から、月内の日を整数として抽出します。
たとえば、日付 2021-06-18 がセル B2 にあるとします。day_of_month(B2) は18を返します。
変数
date: DATE_TIME指定された日付、タイムスタンプ、文字列から、年内の通算日を整数として計算します。
たとえば、日付 2021-06-18 がセル B2 にあるとします。day_of_year(B2) は169を返します。
変数
date: DATE_TIMEドキュメントのメタデータにアクセスします。使用するには、必要なメタデータフィールドの key を渡します。
サポートされるキー:
creator は、ドキュメントの作成者を返します(作成者が判明している場合)。document_identifier は、ドキュメントの内部識別子を返します(たとえば、submit_to_region_with_key 関数で使用されます)。たとえば、document_metadata('creator') は、ドキュメントの作成者のユーザー名を返します。
変数
key: STRING指定された values 配列から値を選択できるドロップダウンを表示します。各値はドロップダウン内の文字列ラベルに変換されるため、values の値は一意である必要があります。
たとえば、=dropdown(array('red', 'blue', 'green')) は、値 'red'、'blue'、'green' を持つドロップダウンを作成します。
selected_value を指定すると、ドロップダウンのデフォルトの文字列ラベルを指定できます。selected_value は任意で、null に設定すると、ドロップダウンの選択はデフォルトで未選択の状態になります。selected_value が設定されていて、選択されたラベルが values 配列内に存在しなくなった場合(基になるデータが変更された場合など)、結果は空のセルになります。
allow_invalid を true に設定すると、この動作をオーバーライドし、以前に保存された選択内容を引き続き出力します。この結果は文字列に限られ、文字列の値から以前に選択した値を保持する場合にのみ推奨されます。
placeholder_text を使うと、値が選択されていないときにドロップダウンにテキストを表示できます(プロンプトや説明として役立ちます)。
変数
values: ARRAYselected_value: STRINGallow_invalid: BOOLEANplaceholder_text: STRING空の結果を返します。if 関数や iferror 関数と組み合わせると便利です(例:if(not isnull(A1), A1, empty_cell()))。
現在の value を等価(==)比較として指定します。
参照関数の引数に適用すると、検索動作が変わります。
変数
value: ANY検索と参照で value との完全一致を探すようにする修飾子を付けた value を返します。
変数
value: ANYe を value 乗した値を返します。定数 e は自然対数の底であり、2.718 に等しくなります。
たとえば、exp(2) は 7.389 を返します。これは、自然対数の底 e を2乗した結果です。
変数
value: NUMBERvalue に tags を追加し、新しいタグ付きの値を返します。
変数
value: ANYtags: ARRAYラベル label のボタンを表示します。このボタンをクリックすると、スプレッドシートが name という名前で folder にコピーされます。
エクスポートは「$name - Export $sheetName」というパターンでコピーされます。対象のエクスポートのシート名を exports に渡すことで、エクスポートを制限できます。必要なエクスポートが1つでもない場合、コピーに失敗します。完了メッセージは onCompleteMessage に、失敗メッセージは onFailureMessage に渡すことができます。redirectToHomeAfterCompletion を true に設定すると、完了後にユーザーは個人フォルダにリダイレクトされます。
変数
label: STRINGfolder: STRINGname: STRINGexports: ARRAYonCompleteMessage: STRINGonFailureMessage: STRINGredirectToHomeAfterCompletion: BOOLEANエラーを出力します。
変数
value: STRINGvalue に関連付けられたタグの配列を返します。
変数
value: ANYタイムアウトするまで I/O をブロックするテストメソッドです。動作に問題のある I/O 関数をシミュレートするために、タイムアウト後に待機する追加の遅延を任意で指定できます。
変数
extra_delay: NUMBER範囲を出力します。
変数
width: NUMBERvalue: ANY配列 tags 内のタグを value から削除します。tags 引数がない場合は、value からすべてのタグを削除します。
変数
value: ANYtags: ARRAY指定された value の階乗を計算します。
たとえば、factorial(3) は6を返します。
変数
value: NUMBER文字列 text_to_search 内で search_for が最初に出現するインデックスを返します。検索の starting_index を任意で指定できます。
たとえば、セル A1 にフレーズ 'The grey cat chased the grey mouse' があるとします。'grey' が最初に出現するインデックスを特定するには、find('grey', A1) を使うと、インデックス5が返されます。
変数
search_for: STRINGtext_to_search: STRINGstarting_index: NUMBER指定された value を、小数部分のない最も近い数値へ切り下げて、床関数の値を計算します。
たとえば、floor(3.2) は3に丸められます。また、floor (-4.5) は-5に丸められます。
変数
value: NUMBER数値セルの value を #,###.## のような形式に書式設定し、decimalPlaces で指定された小数点以下の桁数に丸めます。この関数は結果を文字列として返します。
例:列 A に4桁の数値があり、桁区切りと小数点以下2桁を表示したいとします。format_number(A1, 2) を使うと、最初の数値の書式が #,###.00 に変更されます。ボックスを下にドラッグすると、列 A の残りのセルにも適用されます。
変数
value: NUMBERdecimalPlaces: NUMBERarg を printf スタイルで書式設定し、format を使って結果を文字列属性として返します。
変数
format: STRINGあいまい検索および参照を可能にする修飾子を付けた value を返します。検索対象の値は、実際の値から distance 回以内の編集で一致する値です。編集距離は0、1、2のみサポートされ、デフォルトは2です。
この距離はレーベンシュタイン距離に相当し、ある文字列から別の文字列に変えるために必要な1文字単位の編集回数を表します。
変数
value: ANYdistance: NUMBER指定されたオブジェクトまたはオブジェクトプロパティのオブジェクト RID を返します。
変数
object_or_property: ANY指定されたオブジェクトまたはオブジェクトプロパティのオブジェクトタイプIDを返します。
変数
object_or_property: ANYオブジェクトの指定されたプロパティを返します。
変数
object: OBJECTkey: STRING現在の value を、より大きい(>)比較として指定します。
参照関数の引数に適用すると、検索動作が変わります。
変数
value: ANY現在の value を、以上(>=)の比較として指定します。
参照関数の引数に適用すると、検索動作が変わります。
変数
value: ANYrange の最初の行で value を参照し、row(1から始まる)の値を取得します。
例:列 A が色のリストであるとします。hlookup(A1,A1:A100,5) は、その列の5行目の色を返します。
変数
value: ANYrange: RANGErow: NUMBER指定された日付、タイムスタンプ、文字列から、時を整数として抽出します。この関数は文字列内の日付と分を無視します。
例:セル A2 にタイムスタンプ 2021-02-15 08:30:15 があるとします。hour(A2) は8を返します。
変数
date: DATE_TIMEcondition が true と評価される場合は、value_if_true で指定された値を返します。condition が false と評価される場合は、value_if_false で指定された値を返します。
例:関数 if(A1 >=5, 'True', 'False') を実装するとします。A1 が6の場合、関数は True を返します。A1 が4の場合、関数は False を返します。
変数
condition: BOOLEANvalue_if_true: ANYvalue_if_false: ANYエラーが検出されない場合は value を返します。それ以外の場合は、value_if_error で指定されたエラーをスローします。この関数を使うと、エラーメッセージをより簡潔に管理できます。
例:セル C3 に単純な数式 A1/B2 があるとします。B2 が空白の場合、数式から「Enter a value in B2.」というエラーをスローしたいとします。iferror(A1/B2, 'Enter a value in B2.') を実装します。
変数
value: ANYvalue_if_error: ANYrange 内の、row_offset と column_offset で指定されたセルの内容を返します。row_offset はデータを取得する行を指定し、column_offset はデータを取得する列を指定します。
例:index(A1:C6, 2, 3) は、範囲 A1 の2行目、3列目からデータを取得することを意味します。
注:行オフセットが0に設定されている場合、column_offset で指定された列全体が選択されます。列オフセットが0の場合、row_offset で指定された行全体が選択されます。両方が0の場合、セルの範囲全体が選択されます。
変数
range: RANGErow_offset: NUMBERcolumn_offset: NUMBER内部関数です。
変数
region_id: STRING属性が null または空のセルの場合に true を返します。それ以外の場合、関数は false を返します。
例:列 A に整数と null 値が混在しているとします。isnull(A1) を使うと、列の最初の値が true(つまり null 値)か整数かを判定できます。この数式を下にドラッグすると、列の残りのセルにも適用されます。
変数
value: ANYdate 属性を指定すると、関数は指定された月の最終日を yyyy-MM-dd 形式で返します。注:日付は文字列として入力する必要があります。
例:現在の日付が2021-02-01で、その月の最終日を計算したいとします。last_day('2021-02-01') を使うと、2021-02-28が返されます。注:1月の日付では常に31が返され、2月の日付では年に応じて28または29が返されます。
変数
date: DATE_TIME文字列 text の先頭から、num_chars で指定された文字数分を返します。
例:セル A2 に文字列「John Smith」がある場合、right(A2, 3) は ith を返します。
変数
text: STRINGnum_chars: NUMBER指定された文字列またはバイナリ属性の長さを、文字数に基づいて計算します。
例:length('John Smith') は10を返します。
変数
value: ANY指定された値の自然対数を計算します。値が0以下の場合、関数はエラーを返します。
例:ln(7) は1.9459を返します。
変数
value: NUMBERbase で指定された底を使って、value の対数を計算します。
例:log(8,2) は3を返します。
変数
value: NUMBERbase: NUMBERdataset_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」を参照します。この関数は、フィルターに一致する my_column の値を取得します。
注:
Value を exact または fuzzy 関数で囲むと、完全一致かあいまい一致かを指定できます。Dataset_path を branch 関数で囲むと、参照するデータセットのブランチを指定できます。変数
dataset_path: STRINGresult_column: STRINGcolumn: STRINGvalue: STRINGdataset_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: STRINGresult_column: STRINGcolumn: STRINGvalue: STRINGdataset_path の result_column から、column と value のペアで定義されたフィルターに一致する重複のない値を返します。
例:lookup_distinct('/Users/me/myData', 'my_column', 'first_name', 'John') は、データセット '/Users/me/myData' から first_name = 'John' の行を検索し、列 'my_column' を参照します。この関数は、フィルターに一致する 'my_column' の重複のない値を取得します。
注:
Value を exact 関数または fuzzy 関数でラップすると、完全一致検索かあいまい検索かを指定できます。Dataset_path を branch 関数でラップすると、参照するデータセットのブランチを指定できます。変数
dataset_path: STRINGresult_column: STRINGcolumn: STRINGvalue: STRINGdataset_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' の値を選択肢として含むドロップダウンを返します。この関数は、フィルターに一致する 'my_column' の重複のない値を取得します。
注:新たにインデックス化されたデータセットが見つからない場合は、ページを再読み込みするか、データを探して使用するに移動し、インデックス化されたデータセットを選択してから、再読み込みボタンを選択します。
変数
dataset_path: STRINGresult_column: STRINGselected_value: STRINGcolumn: STRINGvalue: STRINGdatasource_path で指定されたデータソースの列名を返します。必要に応じて、検索対象のデータソースのブランチを指定できます。
注:
変数
datasource_path: STRINGbranch: STRINGdataset_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: STRINGresult_column: STRINGcolumn: STRINGvalue: STRINGdataset_path の列 result_column から、sort_column を基準に、指定された sort_direction で並べ替えた値を返します。'result_column' のデータは、後続の引数である column と value のペアを使って絞り込めます。
注:
sort_column、result_column、および column は、データセット dataset_path 内の列名である必要があります。また、sort_direction には、昇順を指定する 'ASC' または降順を指定する 'DESC' を使用できます。Value を exact 関数または fuzzy 関数でラップすると、完全一致検索かあいまい検索かを指定できます。変数
dataset_path: STRINGresult_column: STRINGsort_column: STRINGsort_direction: STRINGcolumn: STRINGvalue: STRINGvalue に指定された文字列を小文字に変換します。
例:B2 に文字列 'JANE DOE' がある場合、lower(B2) は 'jane doe' を返します。
変数
value: STRINGvalue の文字列属性の左側を、pad に指定された文字列で長さ length まで埋めます。
例:列 A にある電話番号の文字列の左側を、文字列 'NY-' で埋めるとします。埋めた後の電話番号は13文字になります。これを実装するには、lpad(A1, 13, 'NY-') を使用します。結果は NY-########## になります。
変数
value: STRINGlength: NUMBERpad: STRING現在の value を未満(<)の比較として指定します。
検索の動作を変更するには、lookup 関数の引数に適用します。
変数
value: ANY現在の value を以下(<=)の比較として指定します。
検索の動作を変更するには、lookup 関数の引数に適用します。
変数
value: ANYvalue の文字列の左端から空白を削除します。
例:セル A2 に文字列 'John Smith' があり、先頭に4個の空白がある場合、ltrim(A2) はその空白を削除します。
変数
value: STRING指定された 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: ANYrange: RANGEcriteria: NUMBER数値、日付、またはタイムスタンプのグループ内の最大値を返します。
たとえば、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 ダイジェストを計算し、その値を32文字の16進数文字列として返します。
たとえば、セル A2 に文字列「John Smith」があるとします。md5(A2) は 6117323d2cabbc17d44c2b44587f682c を返します。
変数
value: ANYグループ内の数値の平均を返します。
たとえば、mean(5,8,12) の結果は 8.33 になります。
変数
value: NUMBERグループ内の数値の中央値を返します。
たとえば、median(10, 11, 19, 20, 21) は 19 を返します。また、median(A1:A100) はこの範囲内の中央値を返します。
変数
value: NUMBER数値、日付、またはタイムスタンプのグループ内の最小値を返します。
たとえば、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: ANYdate の分を整数として抽出します。
たとえば、セル A2 にタイムスタンプ 2021-02-15 08:30:15 があるとします。minute(A2) は 30 を返します。
変数
date: DATE_TIMEdate の月を整数として抽出します。
たとえば、セル A2 にタイムスタンプ 2021-02-15 08:30:15 があるとします。month(A2) は 2 を返します。
変数
date: DATE_TIME日付 start と end の間の月数を返します。
たとえば、months_between('2020-02-15', '2022-01-15') は 23 を返します。
変数
start: DATE_TIMEend: DATE_TIME指定された values 配列から値を選択できるドロップダウンを表示します。dropdown 関数とは異なり、multidropdown ではユーザーが一度に複数の値を選択できます。各値が対応する文字列ラベルに変換されるため、これらの values は一意である必要があります。
selected_value を指定すると、ドロップダウンのデフォルトの文字列ラベルが指定されます。selected_value は任意で、null に設定できます。その場合、ドロップダウンのデフォルトの選択状態は未選択になります。
注:selected_value が設定されていて、選択されたラベルが(基になるデータが変更された場合などに)values 配列内に見つからなくなった場合、結果は空のセルになります。
allow_invalid を true に設定すると、この動作がオーバーライドされ、以前に保存された選択内容が引き続き出力されます。現在、この結果は文字列のみで、このモードは文字列値からの以前の選択内容を保持する場合にのみ推奨されます。
placeholder_text を使用すると、値が選択されていないときにドロップダウンにテキストを表示できます(プロンプトや手順として役立ちます)。
変数
values: ARRAYselected_value: ARRAYallow_invalid: BOOLEANplaceholder_text: STRING現在の value を不等号(!=)による比較として指定します。
参照関数の引数に適用すると、検索動作が変わります。
変数
value: ANYstart_date と end_date の間の営業日数を整数で返します。営業日には週末が含まれません。現在、この関数は祝日を引数として指定することに対応していません。
たとえば、net_workdays('2021-01-01','2021-02-01') は、祝日を無視した1月の営業日数が23日であるため、23 を返します。
変数
start_date: DATE_TIMEend_date: DATE_TIMEholidays: ANY指定されたオブジェクト RID を持つオブジェクトを読み込みます。
変数
objectRid: STRINGオブジェクトセットの値を候補とするドロップダウンを返します。selected_object_rid は、オブジェクトセットから現在選択されているオブジェクトの RID です。
変数
object_set: ARRAYselected_object_rid: STRINGplaceholder_text: STRING指定されたオブジェクトセット RID を持つオブジェクトセットを読み込みます。
変数
objectSetRid: STRINGparamKey: STRINGparamValue: ANY文字列を日付としてパースします。複数の書式が指定された場合、いずれかの書式でパースに成功するまで、順番に試行されます。
たとえば、parse_date('25/01/2022', 'dd/MM/yyyy') は2022年1月25日の日付を返します。
日付の書式設定とパースに使用するパターンの詳細は、Java DateTimeFormatter のドキュメント ↗を参照してください。
変数
date_string: STRINGformats: STRING文字列をタイムスタンプとしてパースします。複数の書式が指定された場合、いずれかの書式でパースに成功するまで、順番に試行されます。
たとえば、parse_timestamp('25/01/2022 12:03', 'dd/MM/yyyy HH:mm') は2022年1月25日午後12時3分の日付を返します。
変数
timestamp_string: STRINGformats: STRING配列内でその数値を下回る値の割合が pp となる数値を返します。
array:正の数と負の数の配列で、並べ替えられている必要はありません。pp:パーセンタイル。0以上1以下である必要があります。pp=0 は配列の最小値、pp=0.5 は中央値、pp=1 は最大値を返します。=percentile(array(7.25, 5.3, 8, 10), 0.25) は 6.7625 を返します。配列内の値の25%がこの値を下回ります。=percentile(array(12, 20, 10, 25, 28, 30, 34, 60), 0) は配列内の最小値である 10 を返します。=percentile(A2:A9, A13) のように、範囲やセル参照も使用できます。=percentile(array_flatten(A2:A9), A13)変数
array: ARRAYpp: NUMBERvalue を power 乗した結果を返します。
たとえば、pow(5, 2) は 25 を返します。
変数
value: NUMBERpower: NUMBER式内のすべての数値の積を返します。
たとえば、product(6*2) は 12 を返します。
変数
value: ANY日付が属する年内の四半期を整数として抽出します。
たとえば、セル A1 に日付 2021-08-15 があるとします。この日付はその年の第3四半期に属するため、Quarter(A1) は 3 を返します。
変数
date: DATE_TIMEkey と value のペアを、URL クエリパラメーターで安全に使用できるようにエンコードします。
例:=query_params('k1', 'this is long', 'k2', 'v+2') は k1=this%20is%20long&k2=v%2B2 を返します。
変数
key: STRINGvalue: STRINGsort order で並べ替えられた数値の集まりの中で、指定した数値の順位を返します。順位は、その集まりの中のほかの値に対する数値の相対的な位置を表します。
sort order が0に等しい場合、数値の集まりの中での順位は降順で表されます。
sort order が0以外の数値に等しい場合、順位は昇順で表されます。
注:数値の集まりに含まれる数値以外の値はすべて無視されます。
例:セル A1 に94、A2 に79、A3 に83、A4 に96があるとします。Rank(94, A1:A4, 1) は2を返します。これは、94がこの数値の集まりの中で2番目に高い順位の値であるためです。この列の残りの数値の順位を求めるには、数値の集まりを指定する式を A$1$4 に変更します。こうすることで、範囲が変わらなくなります。
変数
number: NUMBERcollection: ARRAYsortOrder: NUMBERvalue 内で search に一致する部分文字列をすべて replace に置き換えます。
例:列 A に動物の一覧があり、一部のセルに「The Dog」のように文字列「The」が含まれているとします。すべての「The」を文字列「One」に置き換えるには、regexp_replace(A1, 'The', 'One') を使用します。新しいセルには「The Dog」の代わりに「One Dog」が表示されます。セルの角を下にドラッグするだけで、列 A の残りのセルにも適用できます。
変数
value: STRINGsearch: STRINGreplace: STRINGvalue を逆順にし、新しい文字列として返します。
例:Reverse('John Smith') は htimS nhoJ を返します。
変数
value: STRING文字列 text の末尾から、num_chars で指定した文字数分の文字を返します。
例:セル A2 に文字列「John Smith」がある場合、left(A2, 3) は Joh を返します。
変数
text: STRINGnum_chars: NUMBERvalue を、decimalPlaces で指定した小数点以下の桁数に四捨五入します。
例:Round(4.56, 1) は4.6を返します。Round(4.56, 0) は5を返します。
変数
value: NUMBERdecimalPlaces: NUMBERvalue の文字列属性の右側を pad の文字列で埋めて、指定した length にします。
例:列 A の電話番号の文字列の右側を、文字列「-NY」で埋めたいとします。新しい番号はすべて13文字になります。rpad(A1, 13, '-NY') を使用すると、##########-NY になります。
変数
value: STRINGlength: NUMBERpad: STRINGvalue で指定した文字列の右端の空白を削除します。
例:セル A2 の文字列「John Smith」の末尾に4個の空白がある場合、rtrim(A2) はその空白を削除します。
変数
value: STRINGdate の秒を整数として抽出します。
例:セル A2 にタイムスタンプ 2021-02-15 08:30:15 があるとします。second(A2) は15を返します。
変数
date: DATE_TIME指定した集合からランダムな要素を取得します。
変数
set: ANY指定した集合を、昇順に並べ替えた配列に変換します。
例:A1 に名前の集合があるとします。set_to_array(A1) はこれらの名前を配列に変換します。
変数
set: ANY属性の SHA-1 ダイジェストを計算し、値を40文字の16進数文字列として返します。
例:sha1('The cow jumped over the moon.') は 6e2780eb20fdaf78f6c8335d0b17526c7ef12a79 を返します。
変数
value: ANYvalue の正弦を計算します。
例:sin(140) は0.98を返します。
変数
value: NUMBER指定した delimiter で text を分割し、分割した文字列を1行に出力します。注:空の文字列は無視されます。
例:セル A1 に文字列「Jane | 24 | F」があるとします。これを分割した文字列の配列にするには、split(A1, '|') を使用します。「[ Jane , 24 , F ]」が返されます。
変数
text: STRINGdelimiter: STRING正規表現構文を使用し、指定した delimiter で text を分割して、分割した文字列を1行に出力します。注:空の文字列は無視されます。
例:セル A1 に文字列「123ABCDE456FGHIJKL789MNOPQ012」があるとします。これを数字以外の文字列の配列に分割する(つまり、任意の数字で分割する)には、=split_regex(A1, '\d+') を使用します。「[ ABCDE, FGHIJKL, MNOPQ ]」が返されます。
変数
text: STRINGdelimiter: STRINGvalue の平方根を計算します。
例:sqrt(16) は4を返します。
変数
value: NUMBERグループ内の式の標本標準偏差を返します。
例:セル A1 に23、A2 に45、A3 に32があるとします。stddev(A1:A3) は11.06を返します。
変数
value: NUMBER引数が母集団全体であると仮定して、グループ内の式の偏りのある標準偏差を返します。引数が母集団の標本のみを表す場合は、代わりに STDDEV を使用します。
変数
value: ANYクリックすると、指定したキーを持つ領域にデータを送信するボタンを作成します。
例:=submit_to_region_with_key('Submit!', 'ri.fusion.main.document...', 'submit_table', TRUE, 'key_column', A2:A10, 'value_column', B2:B10) は、指定したシート内のテーブル「submit_table」の列「key_column」に A2 を、列「value_column」に B2:10 を送信します。
注:送信先のスプレッドシートに表示したい数だけ、key column と value のペアをパラメーターに含めることができます。ただし、表示したいすべてのパラメーターを、送信される順序どおりに指定する必要があります。
変数
button_label: STRING document_identifier: STRING region_name: STRING should_submit: ANY should_submit が true の場合、データが送信されます。key_column: STRING key_column の各値は一意である必要があります。key_value: ANY key_column に送信する特定のセルまたはセル範囲を示します。column: STRINGvalue: ANYクリックすると、指定したキーでリージョンにデータを送信するボタンを作成します。
例:=submit_to_region_with_key_and_timestamp('Submit!', 'ri.fusion.main.document...', 'submit_table', TRUE, 'time', 'key_column', A2:A10, 'value_column', B2:B10) は、指定したシート内のテーブル 'submit_table' の列 'key_column' に A2 を、列 'value_column' に B2:10 を送信します。現在のタイムスタンプは 'time' 列に送信されます。
注:受信先のスプレッドシートに表示する key column と value のペアは、パラメーターに任意の数だけ含められます。ただし、表示するすべてのパラメーターを、送信される順序どおりに列挙する必要があります。
変数
button_label: STRING document_identifier: STRING region_name: STRING should_submit: ANY should_submit が true の場合、データが送信されます。timestamp_column: STRING key_column: STRING key_column 内の各値は一意である必要があります。key_value: ANY key_column に送信する特定のセルまたはセル範囲を示します。column: STRINGvalue: ANYクリック時に送信する値を計算し、対象リージョンの情報をキャッシュする点を除き、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) は、指定したシート内のテーブル 'submit_table' の列 'key_column' に A2 を、列 'value_column' に B2:10 を送信します。現在のタイムスタンプは 'time' 列に送信されます。
注:受信先のスプレッドシートに表示する key column と value のペアは、パラメーターに任意の数だけ含められます。ただし、表示するすべてのパラメーターを、送信される順序どおりに列挙する必要があります。
変数
button_label: STRING document_identifier: STRING region_name: STRING should_submit: ANY should_submit が true の場合、データが送信されます。timestamp_column: STRING key_column: STRING key_column 内の各値は一意である必要があります。key_value: ANY key_column に送信する特定のセルまたはセル範囲を示します。column: STRINGvalue: ANYクリック時に送信する値を計算し、対象リージョンの情報をキャッシュする点を除き、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' に A2 を、列 'value_column' に B2:10 を送信します。
注:受信先のスプレッドシートに表示する key column と value のペアは、パラメーターに任意の数だけ含められます。ただし、表示するすべてのパラメーターを、送信される順序どおりに列挙する必要があります。
変数
button_label: STRING document_identifier: STRING region_name: STRING should_submit: ANY should_submit が true の場合、データが送信されます。key_column: STRING key_column 内の各値は一意である必要があります。key_value: ANY key_column に送信する特定のセルまたはセル範囲を示します。column: STRINGvalue: ANYvalue の index(1始まり)から、長さ length の部分文字列を抽出します。
例:セル A1 に「cow jumped over the moon」というフレーズがあり、部分文字列「cow」を抽出するとします。この部分文字列はインデックス1から始まり、長さは3です。substring(A1, 1, 3) を使用すると、文字列「cow」だけを抽出できます。
変数
value: NUMBERindex: NUMBERlength: NUMBER後続の引数で指定した範囲に対して、function_code(以下で説明)で指定した集計を計算します。range 内にほかの小計(またはネストされた小計)がある場合、二重計上を避けるため、これらのネストされた小計は無視されます。
function_code に使用できるコードは次のとおりです。
変数
function_code: NUMBERrange: RANGEグループ内の式の合計を返します。
例:sum(23,45,32) は100を返します。
変数
value: NUMBER式内の重複しない数値の合計を返します(つまり、重複する値をすべて無視します)。
例:sum_distinct(23,45,32,45) は100を返します。この関数は重複する数値を計算に含めないため、2番目の45を無視します。
変数
value: NUMBER指定された value 内の対応する要素を乗算し、その積の合計を返します。各 value は同じ次元である必要があり、数値以外の引数はすべてゼロとして扱われます。
例:sum_product(A1:A3, B1:B3) は A1B1 + A2B2 + A3*B3 の合計を返します。
変数
value: ANYcriteria_range が condition に等しい場合の、sum_range 内のすべての値の合計を返します。
注:criteria_range と sum_range の範囲のサイズは一致している必要があります。
例:A1 に名のリストがあり、C1 に対応する年齢があるとします。A1 内の名が「John」であるすべての人の年齢を合計するには、sumif(A1:A50, 'John', C1:C50) を使用します。
変数
criteria_range: RANGEcondition: ANYsum_range: RANGE後続の引数で指定された条件に一致する、sum_range 内のすべての値の合計を返します。
例:sumifs(A1:B5, C1:D5, 10, H4:I8, 'John') は、C1 内の対応するセルが10に等しく、かつ H4 内の対応するセルが「John」に等しい、A1 内のすべてのセルの合計を返します。
注:criteria_range と sum_range の範囲のサイズは一致している必要があります。
変数
sum_range: RANGEcriteria_range: RANGEcondition: ANYvalue の正接を計算します。
例:tan(45) は1.6197を返します。
変数
value: NUMBER指定された year、month、day、hour、minute、second を使用して、yyyy-MM-dd HH:mm 形式のタイムスタンプを作成します。
年が1900未満(例:「97」)のタイムスタンプでは、年は1900からのオフセットとして解釈されます(例:「1997」)。
変数
year: NUMBERmonth: NUMBERday: NUMBERhour: NUMBERminute: NUMBERsecond: NUMBER任意の pattern(日付形式)を使用して、タイムスタンプ date を Unix エポック、つまり1970年1月1日00:00:00 GMT からのミリ秒数に変換します。日付には、日付、タイムスタンプ、または文字列を使用できます。文字列を指定する場合は、パース用のパターンを含めることができます。
例:2021-02-15 という文字列があるとします。この日付の pattern は yyyy-MM-dd です。このタイムスタンプを変換するには、to_unix_timestamp('2021-02-15', 'yyyy-MM-dd') を使用します。
変数
date: STRINGpattern: STRINGホバー時にツールチップが表示されるセルを表示します。
tooltip_content 引数は Markdown 文字列として書式設定できます。open_delay 引数を使用すると、ホバーしてからツールチップが表示されるまでの遅延時間を変更できます。
変数
cell_value: ANYtooltip_content: STRINGopen_delay: NUMBERvalue の両端の空白を削除します。
例:セル A1 に文字列「John Smith」があり、その両端にそれぞれ4個の空白があるとします。trim(A1) は、その空白を除いた新しい文字列を作成します。
変数
value: STRING文字列全体を大文字に変換します。
例:セル A1 に名前 John Smith があるとします。Upper(A1) は JOHN SMITH を返します。
変数
value: STRING任意の label を付けて、url へのハイパーリンクを表示します。
例:url('myblog.com', 'My Blog') は、「My Blog」というラベルのハイパーリンクを作成します。
変数
url: STRINGlabel: STRINGURL のパスやパラメーターで安全に使用できるように input をエンコードします。
例:=url(concat('http://example.com/test?param=', url_encode(A5)))
変数
input: ANYグループ内の値の不偏分散を返します。
例:variance(23, 45, 32) は122.33を返します。
変数
value: NUMBERvalue の項目が母集団全体を構成すると仮定して、グループ内の値の偏りのある分散を返します。
注:値が母集団の標本のみを表す場合は、代わりに VARIANCE を使用します。
変数
value: ANYrange の最初の列で value を参照し、column(1から始まる列番号)の値を取得します。
例:列 A が果物名のリストで、列 C が価格のリストであるとします。vlookup(A3,A1:C6,3) はセル A3 の果物名を取得し、指定された範囲の3列目にある対応する価格を返します。
変数
value: ANYrange: RANGEcolumn: NUMBERdate の週番号を整数として計算します。
例:Week_of_year('2021-06-18') は24を返します。
変数
date: DATE_TIME日付(開始日)の前または後に、指定された営業日数だけ離れた日付を表す数値を返します。営業日には週末と休日は含まれません。
例:workday('2010-01-01',10) は、週末が無視されるため、2010-01-15 を返します。別の例:workday('2010-01-01',10, '2010-01-05') は、週末に加えて休日も無視されるため、2010-01-18 を返します。
変数
start_date: DATE_TIMEvalue: NUMBERholidays: ANYdate の年を整数として抽出します。
例:セル A2 にタイムスタンプ 2022-02-15 08:30:15 があるとします。Year(A2) は2022を返します。
変数
date: DATE_TIMEFusion のデフォルトのアクションライブラリメソッドです。
トリガーされたときに、引数として渡された actionCell 参照内のアクションを遅延計算します。
これはそのセルへの依存関係として扱われないため、場合によっては循環依存を回避できます。
変数
actionCell: ANYトリガーされたときに、ある範囲の内容を別の範囲にコピーするアクションです。
変数
source: ANY NULL を指定できます。target: RANGEcopy_result: BOOLEAN true の場合は、計算されたセルの値をコピーします。false または未指定の場合は、セルの数式をコピーします。指定された 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: ARRAYselected_value: STRINGactionBeforeChange: ANYallow_invalid: BOOLEANplaceholder_text: STRING何も操作せず、失敗するアクションです。serial 内で組み合わせて、処理を短絡させることができます。
ラベルを表示します。種類には 'button'、'link'、'tag' のいずれかを指定できます。
たとえば、action.label('button', 'Submit', 'tick', 'success') は、チェックマークと「Submit」という文字が付いた緑色のボタンを表示します。
変数
type: STRINGlabel: STRINGicon: STRING intent: STRING intent はラベルの色を定義します。'primary' は青、'success' は緑、'warning' はオレンジ、'danger' は赤です。Intent とその出力の一覧は、Blueprint ドキュメント ↗で確認できます。指定されたタイトルと Markdown 文字列を持つコンテキストサイドパネルを開きます。
Markdown に CSS スタイルを使用する場合は、.fusion-markdown-panel クラスで適用範囲を限定できます。
変数
panel_title: STRINGmarkdown_content: STRINGURL を開きます。デフォルトでは新規タブで開きます。既存のスプレッドシートページをリダイレクトする場合は、redirect パラメーターを true に設定します。
変数
url: STRINGredirect: BOOLEAN指定されたアクションのリスト内のすべてのアクションを同時にトリガーします。
action: ANYこのサーバーにデプロイされたカスタムアクションを実行します。利用可能なアクションの一覧については、Palantir の担当者にお問い合わせください。
変数
action_name: STRINGarg: ANY直前のアクションが成功(または失敗)した場合にのみ実行するアクションを定義します。
変数
action: ANYactionOnSuccess: ANYactionOnFailure: ANYaction.submit_to_region_with_options(...) 用の、設定可能なキーと値のオプションです。
利用可能なオプション:
変数
key: STRINGvalue: ANY指定されたキーを使用して、リージョンにデータを送信するボタンを作成します。
たとえば、=action.submit_to_region('ri.fusion.main.document...', 'submit_table', TRUE, 'time', 'first_column', A1:A10, 'second_column', B1:B10) は、指定されたシート内のテーブル 'submit_table' に対し、A1 を列 'first_column' に、B1:10 を列 'second_column' に送信します。現在のタイムスタンプは列 'time' に送信されます。
変数
document_identifier: STRING
送信内容の書き込み先となるデータセットの RID を入力します。RID はドキュメントの URL で確認でき、ri.fusion.main... のような形式です。document_metadata('document_identifier') を使用すると、現在のシートの RID を参照できます。
region_name: STRING
書き込み先のテーブルリージョンの名前を指定します。このテーブルリージョンをまだ指定していない場合は、受信先のスプレッドシートに移動し、「テーブルリージョンを作成」ウィジェットを使用して、テーブルにわかりやすい名前を付けます。
should_submit: ANY
送信元のシート内でブール値(つまり true/false)を含む特定の列に対応します。should_submit が true の場合、データが送信されます。
timestamp_column: STRING
現在のタイムスタンプの送信先となる列ヘッダーを指定します。タイムスタンプが不要な場合は null を使用します。
key_column: STRING
値の送信先となる列ヘッダーを指定します。
key_value: ANY
指定された key_column に送信する特定のセルまたはセル範囲を表します。
column: STRING
value: ANY
指定されたキーを使用して、領域にデータを送信するボタンを作成します。
例:=action.submit_to_region_with_options('ri.fusion.main.document...', 'submit_table', TRUE, 'time', 'first_column', A1:A10, 'second_column', B1:B10) は、指定されたシート内のテーブル「submit_table」の「first_column」列に A1 を、「second_column」列に B1:10 を送信します。現在のタイムスタンプは「time」列に送信されます。
変数
document_identifier: STRING ri.fusion.main... のような形式です。document_metadata('document_identifier') を使用すると、現在のシートの RID を参照できます。region_name: STRING submit_options: OPTIONS action.submit_options(...) を使用して、送信アクションで使用する設定可能なオプションを指定します。使用可能な値は submit_options 関数のドキュメントに記載されています。should_submit: ANY should_submit が true の場合、データが送信されます。timestamp_column: STRING null を使用します。key_column: STRING key_value: ANY key_column に送信する特定のセルまたはセル範囲を示します。column: STRINGvalue: ANY何も行わずに成功するアクションです。直列実行に組み込んで、短絡評価に使用できます。
トーストを表示します。ピン!。
dismissButton が定義されている場合、ユーザーが閉じるボタンをクリックするまでトーストが表示され続けます。トーストが action_serial 関数でラップされている場合、その後に続くアクションが実行されます。
変数
message: STRINGintent: STRINGdismissButton: STRINGラベルとアクションを指定すると、ラベルがクリックされたときにアクションを実行します。
action_label 関数でラベルを設定します。
変数
label: ANYaction: ANY範囲と条件のリストを指定すると、すべての条件が満たされていることを検証します。
変数
table_range: RANGEcondition: ANYFusion のデフォルトの検証ライブラリのメソッドです。
列名と許可される値のリストを指定すると、その列の null 以外のすべての値が許可リストに含まれていることを検証します。
変数
column_name: STRINGallowed_values: ARRAY列名のリストを指定すると、空でない行でこれらの列が空でないことを検証します。つまり、これらの列が空になることができるのは、行全体が空の場合のみです。
変数
column_name: STRING列名のリストを指定すると、各列に数値のみが含まれていることを検証します。
変数
column_name: STRING列名と正規表現文字列を指定すると、その列のすべての値が指定された正規表現に一致することを検証します。
column_name は検証対象の列の名前で、validate_table に渡された範囲の最初の行に表示されているものです。その列のすべての値が regex に一致する場合、検証に成功し、メッセージは表示されません。一致しない値がある場合、検証に失敗し、Fusion は一致しなかった行の位置を最大10行分列挙したメッセージを表示します。また、column_name が最初の行に見つからない場合、または regex が空の場合も、メッセージを表示せずに検証に失敗します。
例:column_regex('zip_code', '^[0-9]{5}$') は、zip_code 列のすべての値が 94105 のように正確に5桁の数字で構成されていることを検証します。
変数
column_name: STRINGregex: STRING列名のリストを指定すると、定義されたテーブルにそれらの列が存在することを検証します。
変数
column_name: STRING列名のリストを指定すると、それらの列の組み合わせがテーブル内で一意であることを検証します。たとえば、最初の行に Name と Age という2個の列名が含まれる範囲を指定した場合、2件のレコードが [Bob, 20] と [Bobby, 20] であれば、table_key('Name', 'Age') は成功するはずです。ただし、2件のレコードが [Bob, 20] と [Bob, 20] であれば、table_key('Name', 'Age') は失敗するはずです。
変数
column_name: STRINGデータをプロットするためのメソッドです。これらの関数には chart. 名前空間を接頭辞として付けます。x_values 引数と y_values 引数は、どちらも数値、日付、タイムスタンプ、または文字列を含む1次元のセル範囲または配列である必要があります。
一連の xy 値を棒グラフにプロットします。
たとえば、=chart.bar(A1:A4, B1:B4) はセル内に棒グラフを表示し、A1:A4 の値に対して B1:B4 の値をプロットします。
利用可能なオプション:
変数
x_values: ANYy_values: ANYoptions: ANY設定可能なオプションを使用して、複数の系列をチャートにプロットします。
利用可能なオプション:
Plots-or-options: ANY一連の xy 値を折れ線グラフにプロットします。
たとえば、=chart.line(A1:A4, B1:B4) はセル内に折れ線グラフを表示し、A1:A4 の値に対して B1:B4 の値をプロットします。時系列の値をチャートにするには、x_values に日付またはタイムスタンプの範囲を使用します。
利用可能なオプション:
変数
x_values: ANYy_values: ANYoptions: ANYチャート用の設定可能なキーと値のオプションです。
変数
key: STRINGvalue: ANY時系列を操作するためのメソッドです。ts.timeseries() のように、これらの関数には ts. 名前空間を接頭辞として付けます。
系列内の点の数を返します。
変数
timeSeries: ANY時系列を(秒を基準に)微分します。
変数
timeSeries: ANY系列の最初の値と最後の値の差を返します。
変数
timeSeries: ANY時系列の最初の点のタイムスタンプを返します。
変数
timeSeries: ANY時系列の最初の点の値を返します。
変数
timeSeries: ANY子系列の各点について、その点までの系列の曲線下の総面積を出力します。
3つの積分方法がサポートされています。linear は積分の近似に台形則を使用し、lhs は左リーマン和、lhr は右リーマン和を使用します。
変数
timeSeries: ANYmethod: STRING時系列を絞り込み、末尾の指定された期間の部分を残します。
サポートされる単位:
変数
timeSeries: ANYtimeAmount: NUMBERtimeUnit: STRING時系列の最後の点のタイムスタンプを返します。
変数
timeSeries: ANY時系列の最後の点の値を返します。
変数
timeSeries: ANY時系列全体の最大値を返します。
変数
timeSeries: ANY時系列全体の平均値を返します。
変数
timeSeries: ANY時系列全体の最小値を返します。
変数
timeSeries: ANY各ティックの値に、指定された係数を乗算します。
つまり、ティック (t, v) を含むソース時系列を x 倍にスケーリングすると、スケーリング後の時系列のティックは (t, v * x) になります。
変数
timeSeries: ANYscale: NUMBER時系列の各点の値を、指定された量だけシフトします。
つまり、ティック (t, v) を含むソース時系列を x だけシフトすると、値をシフトした後の時系列のティックは (t, v + x) になります。
変数
timeSeries: ANYshift: NUMBER時系列全体の標準偏差を返します。
変数
timeSeries: ANY時系列の特定の時間範囲を選択します。
変数
timeSeries: ANYstartTime: ANYendTime: ANY指定された ID の時系列を返します。
変数
seriesId: STRING