数式のリファレンス - キャンバス アプリ
この記事では、キャンバス アプリで使用できるすべての機能について説明します。
キャンバス アプリの数式では、多くの要素を組み合わせて使用します。 使用できる要素は、次のとおりです。
- 関数 はパラメータを受け取り、操作を実行し、値を返します。 たとえば、Sqrt(25) は 5 を返します。 関数は、Microsoft Excel 関数をモデルにしています。 関数の中には、副作用を生じさせるものがあります。たとえば、SubmitForm 関数は、Button.OnSelect のような動作の数式内でのみ正しく機能します。
- シグナル は、環境 に関する情報を返します。 たとえば、Location は、デバイスの現在の GPS 座標を返します。 シグナルは、パラメーターを受け取らず、副作用もありません。
- 列挙型 は、事前に定義された定数値を返します。 たとえば、Color は、Color.Red や Color.Blue などの事前定義された値を持つ列挙体です。 一般的な列挙体がこのページに記載されています。関数に固有の列挙体は、関数と併せて説明しています。
- ThisItem や Self などの名前付き演算子は、コンテナー内の情報へのアクセスを提供します。
上記の他にも、次のような要素を使用できます。
A
Abs – 数値の絶対値。
加速度 – デバイスの加速度センサーを読み取ります。
Acos – 数値の逆余弦をラジアン単位で返します。
Acot – 数値の逆余接をラジアン単位で返します。
AddColumns – 列が追加されたテーブルを返します。 ...
And – ブール値 ロジックAND。 すべての引数が true の場合に true を返します。 && 演算子を使用することもできます。
AIClassify – テキストを1つ以上のカテゴリに分類します。
AIExtract – 登録番号、電話番号、人名などの指定されたエンティティを抽出します。
AIReply – 提供したメッセージに対する返信を作成します。
AISentiment – 指定したテキストの感情を検出します。
AISummarize – 指定したテキストを要約します。
AITranslate – 別の言語のテキストを翻訳します。
App – 現在実行中のアプリに関する情報を提供し、アプリの動作を制御します。
Asin – 数値の逆正弦をラジアン単位で返します。
Assert – テストでtrueまたはfalseに評価します。
As – ギャラリー、フォーム、レコード スコープ関数 ( ForAll、 With、 Sum など) 内の現在のレコードに名前を付けます。
AsType – レコード参照を特定のテーブル タイプとして扱います。
Atan – 数値の逆正接をラジアン単位で返します。
Atan2 – (x,y) 座標に基づいて、ラジアン単位で逆正接を返します。
平均 – テーブル式または引数セットの平均を計算します。
B
戻る – 前の画面を表示します。
空白 – データ ソース にNULL値を挿入するために使用できる空白値を返します。
ブール値 – テキスト文字列、数値、または型指定されていない値を ブール値 値に変換します。
C
カレンダー – 現在のロケールのカレンダーに関する情報を取得します。
Char – 文字コードを文字列に変換します。
Choices – 参照列の可能な値のテーブルを返します。
ClearCollect – コレクションからすべてのデータを削除し、レコードのセットを追加します。 ...
ClearData – ローカル デバイスなどのアプリ ホストからコレクションまたはすべてのコレクションをクリアします。
Clock – 現在のロケールの時計に関する情報を取得します。
結合 – 空白の値を置き換え、空白でない値は変更しません。
Collect – コレクションを作成するか、データ ソース にデータを追加します。
Color – プロパティを組み込みのカラー値に設定します。
ColorFade – 色の値をフェードします。
ColorValue – 色の名前または16進コードを色の値に変換します。 CSS
列 – 型指定されていないオブジェクト データ型から列名と値を取得します。
ColumnNames – 型指定されていないオブジェクト データ型から列名と値を取得します。
コンパス – コンパスの方向を返します。
Concat – データ ソース 内の文字列を連結します。
Concatenate – 文字列を連結します。
同時実行 – 複数の数式を同時に評価します。
接続 – ネットワーク接続に関する情報を返します。
コピー – アプリが実行されているデバイスのクリップボードにテキストをコピーします。
Count – 数値を含むテーブル レコードをカウントします。
Cos – ラジアンで指定された角度のコサインを返します。
Cot – ラジアンで指定された角度のコタンジェントを返します。
CountA – 空ではないテーブル レコードをカウントします。
CountIf – 条件を満たすテーブル レコードをカウントします。
CountRows – テーブルレコードをカウントします。
D
DataSourceInfo – データ ソース に関する情報を提供します。
日付 – 年、 月、 日 の値に基づいて日付/時刻の値を返します。
DateAdd – 日付/時刻値に日、月、四半期、または年を追加します。
DateDiff – 2つの日付値を減算し、結果を日、月、四半期、または年で表示します。
DateTime – 日付と時刻の両方の要素に基づいて日付/時刻の値を返します。
DateTimeValue – 日付と時刻の文字列を日付/時刻値に変換します。
DateValue – 日付のみの文字列を日付/時刻値に変換します。
Day – 日付/時刻値の日の部分を取得します。
Dec2Hex – 数値を16進数のテキスト文字列に変換します。
デフォルト – データ ソース のデフォルト値を返します。
度 – ラジアンを度に変換します。
無効 – GPSの読み取り用の 位置情報 などの信号を無効にします。
Distinct – 重複を削除して、テーブルのレコードを要約します。
ダウンロード – Webからローカル デバイスにファイルをダウンロードします。
DropColumns – 1つ以上の列が削除されたテーブルを返します。
E
EDate – 月の日付を変更せずに、日付に月を加算または減算します。
EditForm – アイテムの編集用にフォーム コントロールをリセットします。
有効 – GPSを読み取るための 位置情報 などの信号を有効にします。
EncodeHTML – HTMLコンテキストで使用するためにエスケープする必要がある文字をエンコードします。
EncodeUrl – URLエンコードを使用して特殊文字をエンコードします。
EndsWith – テキスト文字列が別のテキスト文字列で終わるかどうかを確認します。
EOMonth – 日付に月を加算または減算し、その月の最終日を返します。
エラー – カスタム エラーを作成するか、エラーを渡します。
エラー – データ ソース への以前の変更に関するエラー情報を提供します。
exactin – 大文字と小文字を区別して、テキスト文字列が別のテキスト文字列またはテーブル内に含まれているかどうかを確認します。 レコードがテーブルにあるかどうかを確認するためにも使用されます。
Exit – 現在実行中のアプリを終了し、必要に応じて現在のユーザーをサインアウトします。
Exp – e の累乗を返します。
F
Filter – 1つ以上の条件に基づいてフィルタリングされたテーブルを返します。
Find – ある文字列が別の文字列内に存在するかどうかを確認し、その位置を返します。
First – テーブルの最初のレコードを返します。
FirstN – テーブルの最初のレコード セット (Nレコード) を返します。
ForAll – テーブルのすべてのレコードの値を計算し、アクションを実行します。
G
GroupBy – レコードがグループ化されたテーブルを返します。
GUID – GUID文字列をGUID値に変換するか、新しいGUID値を作成します。
H
HashTags – 文字列からハッシュタグ (#strings) を抽出します。
Hex2Dec – 16進数のテキスト文字列を数値に変換します。
ホスト – アプリを実行している現在のホストに関する情報を提供します。
Hour – 日付/時刻値の時間部分を返します。
I
If – 条件が真の場合は1つの値を返します。そうでない場合は別の値を返します。
IfError – エラーを検出し、代替値を提供するか、アクションを実行します。
in – 大文字と小文字を区別せずに、テキスト文字列が別のテキスト文字列またはテーブル内に含まれているかどうかを確認します。 レコードがテーブルにあるかどうかを確認するためにも使用されます。
Index – 順序付けられた位置に基づいてテーブルからレコードを返します。
Int – 最も近い整数に切り捨てます。
IsBlankOrError – 空白 値またはエラーをチェックします。
IsEmpty – 空のテーブルかどうかをチェックします。
IsError – エラーをチェックします。
IsMatch – 文字列をパターンと照合します。 正規表現を使用できます。
IsNumeric – 数値をチェックします。
ISOWeekNum – 日付/時刻値のISO週番号を返します。
IsToday – 日付/時刻値がユーザーのタイムゾーンで今日のいつかであるかどうかを確認します。
IsType – レコード参照が特定のテーブル タイプを参照しているかどうかを確認します。
IsUTCToday – 日付/時刻値が協定世界時 (UTC) で今日のいつかであるかどうかを確認します。
J
JSON – テーブル、レコード、または値のJSONテキスト文字列を生成します。
L
Language – 現在のユーザーの言語タグを返します。
Last – テーブルの最後のレコードを返します。
LastN – テーブルの最後のレコード セット (Nレコード) を返します。
起動 – Webページまたはキャンバス アプリを起動します。
Left – 文字列の左端の部分を返します。
Len – 文字列の長さを返します。
Ln – 自然対数を返します。
LoadData – ローカル デバイスなどのアプリ ホストからコレクションを読み込みます。
位置情報 – 全地球測位システム (GPS) やその他の情報を使用して、現在地を地図座標として返します。
Log – 任意の底の数値の対数を返します。
LookUp – 1つ以上の条件に基づいてテーブル内の単一のレコードを検索します。
Lower – テキスト文字列内のすべての文字を小文字に変換します。
M
Match – パターンに基づいて部分文字列を抽出します。 正規表現を使用できます。
MatchAll – パターンに基づいて複数の部分文字列を抽出します。 正規表現を使用できます。
Max – テーブル式または引数セットの最大値。
Mid – 文字列の中央部分を返します。
Min – テーブル式または引数セットの最小値。
Minute – 日付/時刻値の分部分を取得します。
Mod – 被除数を除数で割った余りを返します。
Month – 日付/時刻値の月の部分を取得します。
N
ナビゲート – 表示される画面を変更します。
NewForm – アイテムの作成のためにフォーム コントロールをリセットします。
Not – ブール値 ロジックNOT。 引数が false の場合は true を、true の場合は false を返します。 ! 演算子を使用することもできます。
通知 – ユーザーにバナーメッセージを表示します。
Now – ユーザーのタイムゾーンにおける現在の日付/時刻の値を返します。
O
または – ブール値 ロジックOR。 引数のいずれかが true の場合に true を返します。 || 演算子を使用することもできます。
P
Param – 起動時にキャンバス アプリに渡されるパラメーターにアクセスします。
親 – コンテナー コントロールのプロパティへのアクセスを提供します。
ParseJSON – テキストとして表されるJSONドキュメントを 型指定されていないオブジェクト 値に変換します。
パッチ – データ ソース 内のレコードを変更または作成するか、データ ソース の外部のレコードをマージします。
PDF – 現在の画面の内容をオブジェクトにエクスポートし、複数のシナリオで使用します。
Pi – 数値 π を返します。
PlainText – 文字列からHTMLタグとXMLタグを削除します。
Power – 累乗した数値を返します。 ^ 演算子を使用することもできます。
Proper – 文字列内の各単語の最初の文字を大文字に変換し、残りを小文字に変換します。
R
ラジアン – 度をラジアンに変換します。
Rand – 0から1の間の疑似乱数を返します。
RandBetween – 2つの数値間の疑似乱数を返します。
ReadNFC – 近距離無線通信 (NFC) タグを読み取ります。
RecordInfo – データ ソース のレコードに関する情報を提供します。
更新 – データ ソース のレコードを更新します。
関連付け – 1対多または多対多の関係を通じて2つのテーブルのレコードを関連付けます。
Remove – データ ソース から1つ以上の特定のレコードを削除します。
RemoveIf – 条件に基づいて データ ソース からレコードを削除します。
RenameColumns – テーブルの列の名前を変更します。
Replace – 文字列の開始位置によって、文字列の一部を別の文字列に置き換えます。
RequestHide – フォームを非表示にします。 SharePoint
リセット – 入力コントロールをデフォルト値にリセットし、ユーザーによる変更をすべて破棄します。
ResetForm – 既存の項目を編集するためにフォーム コントロールをリセットします。
元に戻す – データ ソース のレコードを再読み込みし、エラーをクリアします。
RGBA – 赤、緑、青、アルファのコンポーネントのセットのカラー値を返します。
Right – 文字列の右端の部分を返します。
Round – 最も近い数値に丸めます。
RoundDown – 前の最大の数値に切り捨てます。
RoundUp – 次の最小の数値に切り上げます。
S
SaveData – コレクションをローカル デバイスなどのアプリ ホストに保存します。
検索 – いずれかの列に文字列が含まれるテーブル内のレコードを検索します。
Second – 日付/時刻値の秒の部分を取得します。
選択 – コントロール上で 選択 アクションをシミュレートし、 OnSelect 数式を評価します。
Self – 現在のコントロールのプロパティへのアクセスを提供します。
Sequence – 連続番号のテーブルを生成します。 ForAll で反復処理するときに便利です。
SendAppNotification (プレビュー) – オプションのアクションを含むアプリ内通知を受信者に送信します。
Set – グローバル変数の値を設定します。
SetFocus – 入力フォーカスを特定のコントロールに移動します。
SetProperty – 入力コントロールとのやり取りをシミュレートします。
ShowColumns – 選択した列のみを含むテーブルを返します。
ShowHostInfo – アプリ内のユーザーに情報を表示します。
シャッフル – テーブルのレコードをランダムに並べ替えます。
Sin – ラジアンで指定された角度の正弦を返します。
Sort – 数式に基づいて並べ替えられたテーブルを返します。
SortByColumns – 1つ以上の列に基づいて並べ替えられたテーブルを返します。
Split – テキスト文字列を部分文字列のテーブルに分割します。
Sqrt – 数値の平方根を返します。
StartsWith – テキスト文字列が別のテキスト文字列で始まるかどうかを確認します。
StdevP – 引数の標準偏差を返します。
Substitute – 一致する文字列によって、文字列の一部を別の文字列に置き換えます。
SubmitForm – フォーム コントロール内の項目を データ ソース に保存します。
Sum – テーブル式または引数セットの合計を計算します。
Switch – 値のセットと一致し、対応する数式を評価します。
T
テーブル – 一時テーブルを作成します。
Tan – ラジアンで指定された角度の正接を返します。
テキスト – 任意の値を変換し、数値または日付/時刻値をテキストの文字列にフォーマットします。
ThisItem – ギャラリーまたはフォーム コントロール内の現在のアイテムのレコードを返します。
ThisRecord – ForAll、 With、 Sum などのレコード スコープ関数で現在のアイテムのレコードを返します。
時刻 – 時間、 分、 秒 の値に基づいて日付/時刻の値を返します。
TimeValue – 時刻のみの文字列を日付/時刻値に変換します。
TimeZoneOffset – UTCとユーザーの現地時間の差を分単位で返します。
Today – 現在の日付のみの値を返します。
トレース – テスト結果に追加情報を提供します。
Trim – テキスト文字列の末尾と内部から余分なスペースを削除します。
TrimEnds – テキスト文字列の末尾からのみ余分なスペースを削除します。
Trunc – 小数部分を削除して、数値を整数部分のみに切り捨てます。
U
グループ解除 – グループを削除します。
UniChar – Unicodeコードを文字列に変換します。
関連付け解除 – 1対多または多対多の関係にある2つのテーブルのレコードの関連付けを解除します。
更新 – データ ソース 内のレコードを置き換えます。
UpdateContext – 現在の画面の1つ以上の コンテキスト変数 の値を設定します。
UpdateIf – 条件に基づいて データ ソース 内のレコード セットを変更します。
Upper – テキスト文字列内のすべての文字を大文字に変換します。
ユーザー – 現在のユーザーに関する情報を返します。
UTCNow – 現在の日付/時刻の値を協定世界時 (UTC) で返します。
UTCToday – 協定世界時 (UTC) で現在の日付のみの値を返します。
V
検証 – 単一の列またはレコード全体の値が データ ソース に対して有効かどうかを確認します。
Value – 文字列を数値に変換します。
VarP – 引数の分散を返します。
ViewForm – 既存の項目を表示するためのフォーム コントロールをリセットします。
W
Weekday – 日付/時刻値の曜日部分を取得します。
WeekNum – 日付/時刻値の週番号を返します。
With – 名前付き値のインライン レコードを含む単一のレコードに対して値を計算し、アクションを実行します。
Y
Year – 日付/時刻値の年の部分を取得します。