Documentation
ドキュメントの検索
karat

+

K

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

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

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

引数

  • value: ANY

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

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

例えば: 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)) は配列(3, 1, 4, 2)を返します。

注意: 値の順序は保持されません。また、値に付けられたタグ（例: fuzzyやexact）はすべて削除されます。

引数

  • value: ANY

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

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

例えば: array_flatten('John', A1:B2) の場合、A1 = array('Zoe', 'Charles')、A2 = 'Mary'、B2 = 'Richard'であるとき、結果は配列 [ 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がゼロまたは配列の長さより大きい場合、空の配列が返されます。例: 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: 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座標の逆正接を返します。逆正接は、原点（0, 0）と座標（x_num, y_num）を含む線からx軸までの角度です。この角度は、-ΠからΠの間で与えられます（-Πを除く）。

例えば: 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を返します。検索のブランチを指定するためにルックアップの最初の引数に適用します。

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

引数

  • 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

複数の入力文字列属性を1つの文字列属性に連結し、すべての引数の間に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

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

例えば: 特定の列内のオブジェクトの数を知りたい場合、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

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

例えば: 列Aに動物のリストがあり、最初の100行に'Dog'が何回リストされているかを知りたい場合、countif(A1:A100, 'Dog') を使用して一意のカウントを取得します。

引数

  • range: RANGE
  • criteria: ANY

countifs([range:

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

dataset_path の result_column からフィルター処理された条件に一致する distinct な値を返します。

例えば: lookup_distinct('/Users/me/myData', 'my_column', 'first_name', 'John') は、'/Users/me/myData' データセット内の first_name が 'John' に一致する行を検索し、その行の my_column の distinct な値を取得します。

注意:

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

Arguments

  • 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 の distinct な値を取得します。

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

Arguments

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

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

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

注意:

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

Arguments

  • datasource_path: STRING
  • branch: STRING

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

フィルター処理された条件に一致する dataset_path の result_column から一致する値を無順序のセットとして返します。

例えば: 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 を選択してから再読み込みボタンを選択してください。

Arguments

  • 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

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

注意:

  • sort_column、result_column、および column はすべて dataset_path データセット内の列名である必要があります。さらに、sort_direction は 'ASC' または 'DESC' のいずれかで、昇順および降順を指定します。
  • Value は exact または fuzzy 関数を使用して、完全一致かあいまい一致かを指定できます。
  • 新しくインデックスされたデータセットが見つからない場合は、ページを再読み込みするか、Find and use data に移動し、Indexed datasets を選択してから再読み込みボタンを選択してください。

Arguments

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

lower(value: string): string

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

例えば: 'JANE DOE' が B2 にあるとします。lower(B2) は 'jane doe' を返します。

Arguments

  • value: STRING

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

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

例えば: 電話番号の文字列を 'NY-' で左側に埋めたいとします。各埋められた電話番号は 13 文字になります。これを実装するには、lpad(A1, 13, 'NY-') を使用して NY-########## を取得します。

Arguments

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

lt(value: any): same_as_first_argument

現在の value をより小さい (<) 比較としてマークします。

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

Arguments

  • value: ANY

lte(value: any): same_as_first_argument

現在の value を以下または等しい (<=) 比較としてマークします。

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

Arguments

  • value: ANY

ltrim(value: string): string

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

例えば: 'John Smith' という文字列が A2 にあり、4 つの先頭スペースがある場合、ltrim(A2) はスペースを削除します。

Arguments

  • 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) という式は 25 が範囲の 2 番目のアイテムであるため、2 を返します。

Arguments

  • 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' を返します。

Arguments

  • value: ANY

md5(value: any): string

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

例えば: 'John Smith' という文字列が A2 にあるとします。md5(A2) は 6117323d2cabbc17d44c2b44587f682c を返します。

Arguments

  • value: ANY

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

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

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

Arguments

  • value: NUMBER

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

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

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

Arguments

  • 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’ を返します。

Arguments

  • value: ANY

minute(date: date_time): number

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

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

Arguments

  • date: DATE_TIME

month(date: date_time): number

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

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

Arguments

  • date: DATE_TIME

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

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

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

Arguments

  • start: DATE_TIME
  • end: DATE_TIME

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

提供された values 配列から選択可能な値を持つドロップダウンを表示します。ドロップダウン関数とは異なり、multidropdown は同時に複数の値を選択できます。これらの values は一意である必要があります。各値は文字列のラベルに変換されます。

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

注意: selected_value が設定され、選択されたラベルが values 配列に見つからなくなった場合 (基礎データが変更された場合など)、結果は空のセルになります。

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

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

Arguments

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

neq(value: any): same_as_first_argument

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

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

Arguments

  • value: ANY

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

開始日と終了日の間の営業日の数を返します。営業日は週末を除外します。現在、この関数は holidays を引数としてサポートしていません。

例えば: net_workdays('2021-01-01','2021-02-01') は 23 を返します。これは 1 月の間の営業日数を示しています (祝日を無視します)。

Arguments

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

object(objectRid: string): object [EXPERIMENTAL]

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

Arguments

  • objectRid: STRING

object_dropdown(object_set: array, [selected_object_rid: string], [placeholder_text: string]): object [EXPERIMENTAL]

オブジェクトセットからサジェストされた値のドロップダウンを返します。selected_object_rid は現在のオブジェクトセットから選択されたオブジェクトの RID です。

Arguments

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

object_set(objectSetRid: string, [paramKey: string, paramValue: any, ...]): array [EXPERIMENTAL]

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

Arguments

  • 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 ↗ を参照してください。

Arguments

  • 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:03 の日時を返します。

Arguments

  • timestamp_string: STRING
  • formats: STRING

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

array 内の pp 値がそれ以下にある数を返します。

  • array: ソートされていない正/負の数値の配列。
  • pp: パーセンタイルは 0 から 1 までの範囲でなければなりません。pp=0 は配列の最小値を返し、`pp=0

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をUNIXエポックに変換します。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引数はマークダウン文字列としてフォーマットできます。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

値が母集団全体を形成すると仮定して、グループ内の値の有偏分散を返します。

注意: それらが母集団の一部のみを表す場合は、代わりに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

Action functions

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

compute_on_trigger(actionCell: any): any [EXPERIMENTAL]

トリガーされたときに引数として渡されたactionCellリファレンス内のActionを遅延実行します。

これはそのセルへの依存関係としてカウントされないため、一部のケースで循環依存を避けることができます。

引数

  • actionCell: ANY

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

トリガーされたときにある範囲から別の範囲へ内容をコピーするActionです。

引数

  • 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が提供された場合、新しく選択されたドロップダウンの値が保存され、他の式によって考慮される前に実行されるActionを指定します。

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

何も操作しない失敗したActionです。短絡のためにシリアル内で結合できます。

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'は赤です。intentの完全なリストとその出力を確認できます：Blueprint documentation ↗.

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

このサーバーにデプロイされたカスタムActionを実行します。利用可能なActionのリストを取得するには、Palantirの担当者にお問い合わせください。

引数

  • action_name: STRING
  • arg: ANY

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

前のActionの成功（または失敗）にのみ発生するActionを定義します。

引数

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

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

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

利用可能なオプション:

  • submitEmptyCells: 空またはnullのセルが、送信先テーブルのこの列に存在するデータを上書きします
  • succeedWhenNoRows: shouldSubmitがfalseまたはすべての行に対してfalseの場合に、失敗してトーストを表示する代わりに、Actionが成功するように動作を変更します

引数

  • 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を指定されたシート内の'time'列、'first_column'、'second_column'のテーブル'submit_table'にそれぞれ送信します。現在のタイムスタンプは'time'列に送信されます。

引数

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

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

  • should_submit: ANY
    Boolean（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 [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を指定されたシート内の'time'列、'first_column'、'second_column'のテーブル'submit_table'にそれぞれ送信します。現在のタイムスタンプは'time'列に送信されます。

引数

  • document_identifier: STRING
    送信内容が書き込まれるデータセットのRIDを挿入します。RIDはドキュメントのURLで識別でき、ri.fusion.main...のように見えます。現在のシートのRIDを参照するには、document_metadata('document_identifier')を使用できます。
  • region_name: STRING
    書き込むテーブルリージョン