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