注: 以下の翻訳の正確性は検証されていません。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: array, value: any): boolean

array に value が含まれているかどうかを確認します。配列にその値が含まれている場合、この関数は true を返します。

たとえば、セル E7 に配列 [ John, Mary, Richard ] がある場合、array_contains(E7, 'Richard') を実行すると、配列内に値 'Richard' があるかどうかを確認します。この場合、関数は True を返します。array_contains(E7, 'Louise') を入力すると、関数は False を返します。

変数

  • array: ARRAY
  • value: ANY

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

最初の配列に含まれ、ほかのどの配列にも含まれない一意の要素をすべて返します。順序は保証されません。

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

変数

  • array: ARRAY
  • differenceArrays: ARRAY

array_distinct([value: any, ...]): array

入力引数の一意の値のみを含む配列を返します。

たとえば、array_distinct(array(3, 2, 1), 4, array(1, 2)) は array(3, 1, 4, 2) を返します。

注:値の順序は保持されません。また、値に付いているタグ(あいまい一致や完全一致など)はすべて削除されます。

変数

  • value: ANY

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

入力されたすべての属性から配列を作成します。作成された配列は [角括弧] で囲まれます。すべての属性が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_get_at_index(array: array, index: number): any

指定された array の位置 index(1始まりのインデックス)にある要素を返します。

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

変数

  • array: ARRAY
  • index: NUMBER

array_get_first(array: array): any

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

変数

  • array: ARRAY

array_get_last(array: array): any

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

変数

  • array: ARRAY

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

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

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

変数

  • array: ARRAY
  • intersectionArrays: ARRAY

array_length(array: array): number

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

たとえば、セル E7 に配列 [ John, Mary, Richard ] があり、配列の長さを確認するには、array_length(E7) と入力します。配列には3個の属性があるため、関数は値3を返します。

変数

  • array: ARRAY

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

array の 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: ARRAY
  • start_index: NUMBER
  • end_index: NUMBER

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

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

たとえば、セル E7 に配列 [ 3, 4, 1 ] があり、配列を並べ替えるには、array_sort(E7, 'DESC') と入力します。関数は配列 [ 4, 3, 1 ] を返します。

変数

  • array: ARRAY
  • sort_direction: ANY

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: ARRAY

asin(value: number): number

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

たとえば、asin(-1) は値 -Π/2 を返します。

変数

  • value: NUMBER

atan(value: number): number

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

たとえば、atan(0) は値0を返します。

変数

  • value: NUMBER

atan2(x_num: number, y_num: number): number

指定された x 座標と y 座標のアークタンジェント(逆正接)を返します。アークタンジェントは、x 軸から、原点 (0, 0) と座標 (x_num, y_num) の点を通る直線までの角度です。角度は -Π を除く -Π から Π までの範囲で、ラジアン単位で表されます。

例:atan2(1,1) は値 0.785398163 を返します。

変数

  • x_num: NUMBER
  • y_num: NUMBER

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

指定された range の数値の平均を計算します。この範囲は、値の集合または値の範囲として入力できます。

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

変数

  • range: RANGE

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

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

例:binary(0, 0, 127)。

変数

  • value: ANY

branch(dataset_path: string, branch_name: string): same_as_first_argument

branch_name でタグ付けされた dataset_path を返します。検索で使用するブランチを指定するには、参照の最初の引数に適用します。

注:新しくインデックス化されたデータセットが見つからない場合は、ページを再読み込みするか、データを探して使用するに移動してインデックス化されたデータセットを選択し、再読み込みボタンを選択します。

変数

  • dataset_path: STRING
  • branch_name: STRING

case_toggle(value: string): string

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

変数

  • value: STRING

cbrt(value: number): number

指定された value の立方根を計算します。

例:cbrt(8) は 2 を返します。

変数

  • value: NUMBER

ceil(value: number): number

指定された value を小数部分のない最も近い数値に切り上げて、天井値を計算します。

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

変数

  • value: NUMBER

checkbox([checked: boolean], [label: string]): boolean

チェックされている場合に true を返し、それ以外の場合に false を返すチェックボックスを表示します。ラベルは任意です。checked 引数が指定されていない場合、デフォルトは false で、チェックされていない状態です。

変数

  • checked: BOOLEAN
  • label: STRING

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

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

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

変数

  • arg: ANY

color(cell_value: any, [text_color: string], [background_color: string]): any

指定された文字色と背景色でセルを表示します。

変数

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

concat([arg: string, ...]): 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

concat_ws(separator: string, [arg: string, ...]): string

すべての引数の間に separator を挿入し、複数の入力文字列属性を連結して、1つの文字列属性にします。コレクション型の引数はすべて再帰的にフラット化されます。

例:名の 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

グループ内の項目の件数を返します。

例:特定の列に含まれるオブジェクトの件数を知りたいとします。count 関数を選択して列をハイライトすると、値を取得できます。

変数

  • 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 に値 Red を含み、列 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 の間の日数を知りたいとします。2021-01-15 はセル B2 に、2021-06-15 はセル 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 のバリエーションを使用できます。

例:date_format('2021-05-06', 'MM-dd-yy') を使用して、日付 2021-05-06 の形式を 05-06-21 に変更します。

変数

  • date: DATE_TIME
  • format: STRING

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

dateOrDaysLeft から 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: ANY
  • dateOfDaysRight: ANY

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

選択された日付を持つ日付ピッカーを返します。日付は yyyy-MM-dd 形式である必要があり、任意で HH:mm(時刻情報)を追加できます。時刻の精度は '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

e を value 乗した値を返します。定数 e は自然対数の底であり、2.718 に等しくなります。

たとえば、exp(2) は 7.389 を返します。これは、自然対数の底 e を2乗した結果です。

変数

  • value: NUMBER

experimental_add_tags(value: any, tags: array): same_as_first_argument [試験的]

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 [試験的]

ラベル label のボタンを表示します。このボタンをクリックすると、スプレッドシートが name という名前で folder にコピーされます。

エクスポートは「$name - Export $sheetName」というパターンでコピーされます。対象のエクスポートのシート名を exports に渡すことで、エクスポートを制限できます。必要なエクスポートが1つでもない場合、コピーに失敗します。完了メッセージは onCompleteMessage に、失敗メッセージは onFailureMessage に渡すことができます。redirectToHomeAfterCompletion を true に設定すると、完了後にユーザーは個人フォルダにリダイレクトされます。

変数

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

experimental_error([value: string, ...]): any [試験的]

エラーを出力します。

変数

  • 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

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

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

例:列 A に4桁の数値があり、桁区切りと小数点以下2桁を表示したいとします。format_number(A1, 2) を使うと、最初の数値の書式が #,###.00 に変更されます。ボックスを下にドラッグすると、列 A の残りのセルにも適用されます。

変数

  • value: NUMBER
  • decimalPlaces: NUMBER

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

arg を printf スタイルで書式設定し、format を使って結果を文字列属性として返します。

変数

  • format: STRING

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

あいまい検索および参照を可能にする修飾子を付けた value を返します。検索対象の値は、実際の値から distance 回以内の編集で一致する値です。編集距離は0、1、2のみサポートされ、デフォルトは2です。

この距離はレーベンシュタイン距離に相当し、ある文字列から別の文字列に変えるために必要な1文字単位の編集回数を表します。

変数

  • 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 が true と評価される場合は、value_if_true で指定された値を返します。condition が false と評価される場合は、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 が空白の場合、数式から「Enter a value in B2.」というエラーをスローしたいとします。iferror(A1/B2, 'Enter a value in 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 で指定された行全体が選択されます。両方が0の場合、セルの範囲全体が選択されます。

変数

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

internal_region_result(region_id: string): any [試験的]

内部関数です。

変数

  • 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 で指定された文字数分を返します。

例:セル A2 に文字列「John Smith」がある場合、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」を参照します。この関数は、フィルターに一致する my_column の値を取得します。

注:

  • Value を exact または fuzzy 関数で囲むと、完全一致かあいまい一致かを指定できます。Dataset_path を branch 関数で囲むと、参照するデータセットのブランチを指定できます。
  • 新しくインデックス化されたデータセットが見つからない場合は、ページを再読み込みするか、データを探して使用するに移動し、インデックス化されたデータセットを選択してから、再読み込みボタンを選択します。

変数

  • 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 関数でラップすると、完全一致検索かあいまい検索かを指定できます。
  • 新たにインデックス化されたデータセットが見つからない場合は、ページを再読み込みするか、データを探して使用するに移動し、インデックス化されたデータセットを選択してから、再読み込みボタンを選択します。

変数

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

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

dataset_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: STRING
  • result_column: STRING
  • column: STRING
  • value: STRING

lookup_dropdown(dataset_path: string, result_column: string, [selected_value: string], [column: 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' の値を選択肢として含むドロップダウンを返します。この関数は、フィルターに一致する 'my_column' の重複のない値を取得します。

注:新たにインデックス化されたデータセットが見つからない場合は、ページを再読み込みするか、データを探して使用するに移動し、インデックス化されたデータセットを選択してから、再読み込みボタンを選択します。

変数

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

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

datasource_path で指定されたデータソースの列名を返します。必要に応じて、検索対象のデータソースのブランチを指定できます。

注:

  • 列名は配列として返されます。
  • 新たにインデックス化されたデータセットが見つからない場合は、ページを再読み込みするか、データを探して使用するに移動し、インデックス化されたデータセットを選択してから、再読み込みボタンを選択します。

変数

  • datasource_path: STRING
  • branch: STRING

[非推奨] lookup_set(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: STRING
  • result_column: STRING
  • column: STRING
  • value: STRING

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

dataset_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: STRING
  • result_column: STRING
  • sort_column: STRING
  • sort_direction: STRING
  • column: STRING
  • value: STRING

lower(value: string): string

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

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

変数

  • value: STRING

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

value の文字列属性の左側を、pad に指定された文字列で長さ length まで埋めます。

例:列 A にある電話番号の文字列の左側を、文字列 'NY-' で埋めるとします。埋めた後の電話番号は13文字になります。これを実装するには、lpad(A1, 13, 'NY-') を使用します。結果は NY-########## になります。

変数

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

lt(value: any): same_as_first_argument

現在の value を未満(<)の比較として指定します。

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

変数

  • value: ANY

lte(value: any): same_as_first_argument

現在の value を以下(<=)の比較として指定します。

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

変数

  • value: ANY

ltrim(value: string): string

value の文字列の左端から空白を削除します。

例:セル A2 に文字列 'John Smith' があり、先頭に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 を不等号(!=)による比較として指定します。

参照関数の引数に適用すると、検索動作が変わります。

変数

  • 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日であるため、23 を返します。

変数

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

object(objectRid: string): 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 [試験的]

指定されたオブジェクトセット 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 のドキュメント ↗を参照してください。

変数

  • 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日午後12時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) は 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: 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 があるとします。この日付はその年の第3四半期に属するため、Quarter(A1) は 3 を返します。

変数

  • date: DATE_TIME

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

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

例:=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 が0以外の数値に等しい場合、順位は昇順で表されます。

注:数値の集まりに含まれる数値以外の値はすべて無視されます。

例:セル A1 に94、A2 に79、A3 に83、A4 に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 Dog」のように文字列「The」が含まれているとします。すべての「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 で指定した文字数分の文字を返します。

例:セル A2 に文字列「John Smith」がある場合、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 を分割し、分割した文字列を1行に出力します。注:空の文字列は無視されます。

例:セル A1 に文字列「Jane | 24 | F」があるとします。これを分割した文字列の配列にするには、split(A1, '|') を使用します。「[ Jane , 24 , F ]」が返されます。

変数

  • text: STRING
  • delimiter: STRING

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

正規表現構文を使用し、指定した delimiter で text を分割して、分割した文字列を1行に出力します。注:空の文字列は無視されます。

例:セル 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 に23、A2 に45、A3 に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) は、指定したシート内のテーブル「submit_table」の列「key_column」に A2 を、列「value_column」に B2:10 を送信します。

注:送信先のスプレッドシートに表示したい数だけ、key column と value のペアをパラメーターに含めることができます。ただし、表示したいすべてのパラメーターを、送信される順序どおりに指定する必要があります。

変数

  • button_label: STRING
    ボタンに表示する文字列を指定します。
  • document_identifier: STRING
    送信データの書き込み先となるデータセットの RID を入力します。RID はドキュメントの URL で確認でき、ri.fusion.main... のような形式です。
  • region_name: STRING
    書き込み先のテーブル領域の名前を指定します。このテーブル領域をまだ指定していない場合は、送信先のスプレッドシートに移動し、「テーブル領域を作成」ウィジェットを使用して、わかりやすい名前をテーブルに付けます。
  • should_submit: ANY
    送信元のシート内で、ブール値(true/false)を含む特定の列に対応します。should_submit が true の場合、データが送信されます。
  • key_column: STRING
    値の送信先となる列ヘッダーを指定します。key_column の各値は一意である必要があります。
  • key_value: ANY
    指定した key_column に送信する特定のセルまたはセル範囲を示します。
  • 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) は、指定したシート内のテーブル 'submit_table' の列 'key_column' に A2 を、列 'value_column' に B2:10 を送信します。現在のタイムスタンプは 'time' 列に送信されます。

注:受信先のスプレッドシートに表示する key column と value のペアは、パラメーターに任意の数だけ含められます。ただし、表示するすべてのパラメーターを、送信される順序どおりに列挙する必要があります。

変数

  • button_label: STRING
    ボタンに表示する文字列を指定します。
  • document_identifier: STRING
    送信内容の書き込み先となるデータセットの RID を入力します。RID はドキュメントの URL から特定でき、ri.fusion.main... のような形式です。
  • region_name: STRING
    書き込み先のテーブルリージョンの名前を指定します。このテーブルリージョンをまだ指定していない場合は、受信先のスプレッドシートに移動し、「テーブルリージョンを作成」ウィジェットを使用して、テーブルにわかりやすい名前を付けます。
  • should_submit: ANY
    送信元のシートでブール値(true/false)を含む特定の列に対応します。should_submit が true の場合、データが送信されます。
  • timestamp_column: STRING
    現在のタイムスタンプの送信先となる列ヘッダーを指定します。
  • key_column: STRING
    値の送信先となる列ヘッダーを指定します。key_column 内の各値は一意である必要があります。
  • key_value: ANY
    指定した key_column に送信する特定のセルまたはセル範囲を示します。
  • 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) は、指定したシート内のテーブル 'submit_table' の列 'key_column' に A2 を、列 'value_column' に B2:10 を送信します。現在のタイムスタンプは 'time' 列に送信されます。

注:受信先のスプレッドシートに表示する key column と value のペアは、パラメーターに任意の数だけ含められます。ただし、表示するすべてのパラメーターを、送信される順序どおりに列挙する必要があります。

変数

  • button_label: STRING
    ボタンに表示する文字列を指定します。
  • document_identifier: STRING
    送信内容の書き込み先となるデータセットの RID を入力します。RID はドキュメントの URL から特定でき、ri.fusion.main... のような形式です。
  • region_name: STRING
    書き込み先のテーブルリージョンの名前を指定します。このテーブルリージョンをまだ指定していない場合は、受信先のスプレッドシートに移動し、「テーブルリージョンを作成」ウィジェットを使用して、テーブルにわかりやすい名前を付けます。
  • should_submit: ANY
    送信元のシートでブール値(true/false)を含む特定の列に対応します。should_submit が true の場合、データが送信されます。
  • timestamp_column: STRING
    現在のタイムスタンプの送信先となる列ヘッダーを指定します。
  • key_column: STRING
    値の送信先となる列ヘッダーを指定します。key_column 内の各値は一意である必要があります。
  • key_value: ANY
    指定した key_column に送信する特定のセルまたはセル範囲を示します。
  • 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, [column: 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' に A2 を、列 'value_column' に B2:10 を送信します。

注:受信先のスプレッドシートに表示する key column と value のペアは、パラメーターに任意の数だけ含められます。ただし、表示するすべてのパラメーターを、送信される順序どおりに列挙する必要があります。

変数

  • button_label: STRING
    ボタンに表示する文字列を指定します。
  • document_identifier: STRING
    送信内容の書き込み先となるデータセットの RID を入力します。RID はドキュメントの URL から特定でき、ri.fusion.main... のような形式です。
  • region_name: STRING
    書き込み先のテーブルリージョンの名前を指定します。このテーブルリージョンをまだ指定していない場合は、受信先のスプレッドシートに移動し、「テーブルリージョンを作成」ウィジェットを使用して、テーブルにわかりやすい名前を付けます。
  • should_submit: ANY
    送信元のシートでブール値(true/false)を含む特定の列に対応します。should_submit が true の場合、データが送信されます。
  • key_column: STRING
    値の送信先となる列ヘッダーを指定します。key_column 内の各値は一意である必要があります。
  • key_value: ANY
    指定した key_column に送信する特定のセルまたはセル範囲を示します。
  • column: STRING
  • 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: NUMBER
  • index: NUMBER
  • length: NUMBER

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: NUMBER
  • range: RANGE

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

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

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

変数

  • value: NUMBER

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

式内の重複しない数値の合計を返します(つまり、重複する値をすべて無視します)。

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

変数

  • value: NUMBER

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') は、C1 内の対応するセルが10に等しく、かつ H4 内の対応するセルが「John」に等しい、A1 内のすべてのセルの合計を返します。

注: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 を 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: STRING
  • pattern: STRING

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

ホバー時にツールチップが表示されるセルを表示します。

tooltip_content 引数は Markdown 文字列として書式設定できます。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

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

例:=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 [試験的]

トリガーされたときに、引数として渡された 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 [試験的]

指定された 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

何も操作せず、失敗するアクションです。serial 内で組み合わせて、処理を短絡させることができます。


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 ドキュメント ↗で確認できます。
  • intent: STRING
    intent はラベルの色を定義します。'primary' は青、'success' は緑、'warning' はオレンジ、'danger' は赤です。Intent とその出力の一覧は、Blueprint ドキュメント ↗で確認できます。

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

指定されたタイトルと Markdown 文字列を持つコンテキストサイドパネルを開きます。

Markdown に 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 [試験的]

action.submit_to_region_with_options(...) 用の、設定可能なキーと値のオプションです。

利用可能なオプション:

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

変数

  • 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) は、指定されたシート内のテーブル '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


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 [試験的]

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

例:=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
    送信データの書き込み先となるデータセットの RID を挿入します。RID はドキュメントの URL から特定でき、ri.fusion.main... のような形式です。document_metadata('document_identifier') を使用すると、現在のシートの RID を参照できます。
  • region_name: STRING
    書き込み先のテーブル領域の名前を指定します。このテーブル領域をまだ指定していない場合は、受信側のスプレッドシートに移動し、「テーブル領域を作成」ウィジェットを使用して、テーブルにわかりやすい名前を付けます。
  • submit_options: OPTIONS
    action.submit_options(...) を使用して、送信アクションで使用する設定可能なオプションを指定します。使用可能な値は submit_options 関数のドキュメントに記載されています。
  • should_submit: ANY
    送信用シート内でブール値(true/false)を含む特定の列に対応します。should_submit が true の場合、データが送信されます。
  • 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

トーストを表示します。ピン!。

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 は検証対象の列の名前で、validate_table に渡された範囲の最初の行に表示されているものです。その列のすべての値が regex に一致する場合、検証に成功し、メッセージは表示されません。一致しない値がある場合、検証に失敗し、Fusion は一致しなかった行の位置を最大10行分列挙したメッセージを表示します。また、column_name が最初の行に見つからない場合、または regex が空の場合も、メッセージを表示せずに検証に失敗します。

例:column_regex('zip_code', '^[0-9]{5}$') は、zip_code 列のすべての値が 94105 のように正確に5桁の数字で構成されていることを検証します。

変数

  • column_name: STRING
  • regex: STRING

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

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

変数

  • column_name: STRING

table_key([column_name: string, ...]): 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次元のセル範囲または配列である必要があります。


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

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

たとえば、=chart.bar(A1:A4, B1:B4) はセル内に棒グラフを表示し、A1:A4 の値に対して B1:B4 の値をプロットします。

利用可能なオプション:

  • drawLabels: ブール値
  • orientation: "horizontal" | "vertical"

変数

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

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

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

利用可能なオプション:

  • showAxes: ブール値
  • showLegend: ブール値
  • showResetZoomButton: ブール値
  • showToolbar: ブール値
  • tooltip: false | "closest" | "aggregate"
  • yAxisInset: ブール値
  • rangeSelection: "select" | "visual" | false
  • height: 数値 (px)
  • width: 数値 (px)
  • Plots-or-options: ANY

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

一連の xy 値を折れ線グラフにプロットします。

たとえば、=chart.line(A1:A4, B1:B4) はセル内に折れ線グラフを表示し、A1:A4 の値に対して B1:B4 の値をプロットします。時系列の値をチャートにするには、x_values に日付またはタイムスタンプの範囲を使用します。

利用可能なオプション:

  • dataMarkers: ブール値
  • color: 文字列

変数

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

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

チャート用の設定可能なキーと値のオプションです。

変数

  • key: STRING
  • value: ANY

時系列関数

時系列を操作するためのメソッドです。ts.timeseries() のように、これらの関数には ts. 名前空間を接頭辞として付けます。


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: STRING

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

時系列を絞り込み、末尾の指定された期間の部分を残します。

サポートされる単位:

  • hours/h
  • minutes/m
  • seconds/s
  • microseconds/us
  • nanoseconds/ns

変数

  • timeSeries: ANY
  • timeAmount: NUMBER
  • timeUnit: STRING

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