公式參考 - Power Apps

在本文中,您將瞭解 Power Apps 中所有可用的功能。

Power Apps 中的公式結合了許多元素。 分列如下︰

  • Functions 接受參數、執行運算然後傳回值。 例如,Sqrt(25) 傳回 5。 函數會在 Microsoft Excel 函數後建立模形。 有些函數會有副面效果,例如 SubmitForm 只適合 行為公式 (如 Button.OnSelect)。
  • Signals 傳回環境相關資訊。 例如,Location 傳回裝置目前的 GPS 座標。 訊號不接受參數或有副面效果。
  • 列舉 傳回預先定義的常數值。 例如,Color 是已預先定義 Color.RedColor.Blue 等值的列舉。 常見列舉也一併納入;特定函數的列舉會和函數一同說明。
  • 具名運算子,例如 ThisItemSelf,可從容器內存取資訊。

其他元素包括︰

A

Abs – 數字的絕對值。

Acceleration – 讀取裝置中的加速感應器。

Acos – 傳回數字的反餘弦值,單位為弧度。

Acot – 傳回數字的反餘切值,單位為弧度。

AddColumns – 傳回資料表,其中新增資料行

And – 布林值邏輯 AND。 如果所有引數皆為 true,則傳回 true。 您也可以使用 && 運算子

App – 提供目前所正在執行應用程式和對應用程式行為控制的相關資訊。

Asin – 傳回數字的反正弦值,單位為弧度。

Assert – 在測試中評估為 true 或 false。

As – 在資源庫、表單及記錄範圍函數中命名目前記錄,例如 ForAllWithSum

AsType – 將記錄參考視為特定的資料表類型。

Atan – 傳回數字的反正切值,單位為弧度。

Atan2 – 依據 (x,y) 座標傳回反正切值,單位為弧度。

Average – 計算資料表運算式或一組引數的平均值。

B

Back – 顯示前一個畫面。

Blank – 傳回空白值,用來在資料來源中插入 NULL 值。

布林值 – 將文字字串、數字或非類型化值轉換為布林值。

C

Calendar – 擷取目前地區設定的行事曆相關資訊。

Char – 將字元碼轉譯成字串。

Choices – 傳回查閱欄位的可能值資料表。

Clear – 刪除集合物件中的所有資料。

ClearCollect – 刪除集合物件中的所有資料,然後新增一組記錄

ClearData – 從應用程式主機 (例如本機裝置) 清除一個集合或所有集合。

Clock – 擷取目前地區設定的時鐘相關資訊。

Coalesce – 取代空白值,同時讓非空白值保持不變。

Collect – 建立集合物件或將資料新增至資料來源。

Color – 將屬性設定為內建色彩值。

ColorFade – 淡出色彩值。

ColorValue – 將 CSS 色彩名稱或十六進位碼轉譯為色彩值。

Column – 從非類型化物件資料類型中擷取資料行名稱和值。

ColumnNames – 從非類型化物件資料類型中擷取資料行名稱和值。

Compass – 傳回您的羅盤標題。

Concat – 串連資料來源中的字串。

Concatenate – 串連字串。

Concurrent – 同時彼此評估多個公式。

Connection – 傳回網路連線的相關資訊。

複製 - 在執行應用程式的裝置上將文字複製到剪貼簿。

Count – 計算包含數字的資料表記錄。

Cos – 傳回以弧度指定角度的餘弦值。

Cot – 傳回以弧度指定角度的餘切值。

CountA – 計算非空白的資料表記錄。

CountIf – 計算符合條件的資料表記錄。

CountRows – 計算資料表記錄。

D

DataSourceInfo – 提供資料來源的相關資訊。

Date – 根據值傳回日期/時間值。

DateAdd – 將日、月、季或年加入日期/時間值。

DateDiff – 將兩個日期值相減,並以天、月、季或年顯示結果。

DateTime – 根據日期和時間元件傳回日期/時間值。

DateTimeValue – 將日期和時間字串轉換成日期/時間值。

DateValue – 將僅有日期的字串轉換成日期/時間值。

Day – 擷取日期/時間值的日期部份。

Dec2Hex – 將數字轉換為十六進位文字字串。

Defaults - 傳回資料來源的預設值。

Degrees – 將弧度轉換成角度。

Disable – 停用信號,例如用於讀取 GPS 的位置

Distinct – 摘要資料表的記錄,移除重複項目。

Download – 從網路下載檔案到本機裝置。

DropColumns – 傳回資料表,且其中移除一個或多個欄位。

E

EDate – 在日期中添加或減去月份,而不變更月份中的日期。

EditForm – 重設表單中用於編輯項目的控制項。

Enable – 啟用訊號,例如用於讀取 GPS 的位置

EncodeUrl – 使用 URL 編碼將特殊字元編碼。

EndsWith – 檢查文字字串結尾是否為另一個文字字串。

EOMonth – 在日期中添加或減去月份,傳會該月的最後一天。

Error – 建立自訂錯誤或傳遞錯誤。

Errors – 提供先前變更資料來源的錯誤資訊。

exactin – 檢查文字字串是否包含在另一個文字字串或表格中(區分大小寫)。 也用來檢查記錄是否在表格中。

Exit – 退出目前正在執行的應用程式並非必要地登出目前的使用者。

Exp – 傳回 e 的次方。

F

Filter – 根據一個或多個準則傳回篩選過的資料表。

Find – 檢查字串是否出現在另一個字串中,並傳回其位置。

First – 傳回資料表的第一筆記錄。

FirstN – 傳回資料表的第一組記錄 (N 筆記錄)。

ForAll – 計算值,並對資料表的所有記錄執行動作。

G

GroupBy – 傳回記錄已群組的資料表。

GUID – 將 GUID 字串轉換成 GUID 值或建立新 GUID 值。

H

HashTags – 從字串中擷取主題標籤 (#strings)。

Hex2Dec – 將十六進位文字字串轉換為數字。

主機 - 提供有關執行應用程式之目前主機的資訊。

Hour – 擷取日期/時間值的小時部份。

I

If – 如果條件成立則傳回一個值,不成立則傳回另一個值。

IfError – 偵測錯誤並提供替代值或採取動作。

in – 檢查文字字串是否包含在另一個文字字串或表格中(不區分大小寫)。 也用來檢查記錄是否在表格中。

Index – 根據排序位置從資料表傳回記錄。

Int - 將值向下捨入至最接近的整數。

IsBlank – 檢查空白值。

IsBlankOrError – 檢查是否有空白值或錯誤。

IsEmpty – 檢查空資料表。

IsError – 檢查是否有錯誤。

IsMatch – 檢查字串型態。 可以使用規則運算式。

IsNumeric – 檢查數值。

ISOWeekNum – 傳回日期/時間值的 ISO 週數。

IsToday – 檢查日期/時間值是否是使用者時區中的今天某個時間。

IsType – 檢查記錄參考是否表示特定的資料表類型。

IsUTCToday – 檢查日期/時間值是否是今天的某個時間 (以國際標準時間 (UTC) 表示)。

J

JSON – 產生資料表、記錄或值的 JSON 文字字串。

L

Language – 傳回目前使用者慣用語言的語言標記。

Last – 傳回資料表的最後一筆記錄。

LastN – 傳回資料表的最後一組記錄 (N 筆記錄)。

Launch – 啟動網頁或畫布應用程式。

Left – 傳回字串最左邊的部分。

Len – 傳回字串的長度。

Ln – 傳回自然對數。

LoadData – 從應用程式主機 (例如本機裝置) 載入集合。

Location – 使用全球定位系統 (GPS) 和其他資訊傳回您的位置作為地圖座標。

Log – 傳回以任何數字為底的對數。

LookUp – 依據一個或多個準則查詢資料表中的單一記錄。

Lower – 將文字字串中的字母全部轉換為小寫。

M

Match – 根據型態擷取 substring。 可以使用規則運算式。

MatchAll – 根據型態擷取多個 substrings。 可以使用規則運算式。

Max – 資料表運算式或一組引數的最大值。

Mid – 傳回字串的中間部分。

Min – 資料表運算式或一組引數的最小值。

Minute – 擷取日期/時間值的分鐘部份。

Mod – 傳回被除數除以除數後的餘數。

Month – 擷取日期/時間值的月份部份。

N

Navigate – 變更顯示的畫面控制項。

NewForm – 重設建立項目的 form 控制項。

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 – 傳回兩個數字之間的虛擬亂數。

ReadNFC – 讀取近距離無線通訊 (NFC) 標籤。

RecordInfo – 提供資料來源記錄的資訊。

Refresh – 重新整理資料來源的記錄。

Relate – 透過一對多或多對多關聯性建立兩個資料表記錄的關聯。

Remove – 從資料來源中移除一或多個特定記錄。

RemoveIf – 根據條件移除資料來源中的記錄。

RenameColumns – 重新命名資料表的欄位。

Replace – 以另一個字串取代字串的一部分,從字串的起始位置開始。

RequestHide – 隱藏 SharePoint 表單。

Reset – 將輸入控制項重設為預設值,並捨棄所有使用者的變更。

ResetForm – 重設編輯現有項目的表單控制項。

Revert – 重新載入並清除資料來源記錄的錯誤。

RGBA – 傳回一組紅色、綠色、藍色及 alpha 元件的色彩值。

Right – 傳回字串最右邊的部分。

Round – 四捨五入至最接近的數字。

RoundDown – 四捨五入至最大的上一個數字。

RoundUp – 四捨五入至最小的下一個數字。

S

SaveData – 將集合儲存至應用程式主機 (例如本機裝置)。

Search – 尋找資料表中其中一個欄位包含字串的記錄。

Second – 擷取日期/時間值的秒數部份。

Select – 模擬控制項上的選取動作,導致評估 OnSelect 公式。

Self - 提供對目前控制項屬性的存取。

Sequence – 產生順序編號清單,在使用 ForAll 進行反覆運算時很實用。

SendAppNotification (preview) – 向收件者傳送包含選擇性動作的應用程式內通知。

Set – 設定全域變數值。

SetFocus – 將輸入焦點移至特定的控制項。

SetProperty – 模擬與輸入控制項的互動。

ShowColumns – 傳回僅含選取欄位的資料表。

ShowHostInfo – 在應用程式中向使用者顯示資訊。

Shuffle – 隨機重新排列資料表的記錄。

Sin – 傳回以弧度指定角度的正弦值。

Sort – 傳回依據公式排序的資料表。

SortByColumns – 傳回依據一或多個欄位排序的資料表。

Split – 將文字字串分割成許多子字串。

Sqrt – 傳回數字的平方根。

StartsWith – 檢查文字字串的開頭是否為另一個文字字串。

StdevP – 傳回其引數的標準差。

Substitute – 以另一個字串取代字串的一部分,從符合子串開始。

SubmitForm – 將項目儲存在資料來源的表單控制項中。

Sum – 計算資料表運算式或一組引數的總和。

Switch – 與一組值比對,然後評估對應公式。

T

Table – 建立暫存資料表。

Tan – 傳回以弧度指定角度的正切值。

Text – 轉換任何值並將數字或日期/時間值格式化為文字字串。

ThisItem – 傳回資源庫或表單控制項中目前項目的記錄。

ThisRecord – 傳回記錄範圍函數中目前項目的記錄,例如 ForAllWithSum

Time – 根據值傳回日期/時間值。

TimeValue – 將僅有時間的字串轉換成日期/時間值。

TimeZoneOffset – 傳回 UTC 與使用者當地時間之間的差異,以分鐘為單位。

Today – 傳回目前的只有日期值。

Trace – 提供測試結果的其他資訊。

Trim – 移除文字字串內和結尾的多餘空格。

TrimEnds – 僅移除文字字串結尾的多餘空格。

Trunc – 移除任何小數位部分,將數字截斷為僅整數部分。

U

Ungroup – 移除群組。

Unrelate – 取消一對多或多對多關聯性中,兩個資料表記錄的關聯。

Update – 取代資料來源中的記錄。

UpdateContext – 設定目前畫面控制項中的一個或多個內容變數值。

UpdateIf – 根據條件修改資料來源中的一組記錄。

Upper – 將文字字串中的字母全部轉換為大寫。

User – 傳回目前使用者的相關資訊。

UTCNow – 傳回目前日期/時間值 (以國際標準時間 (UTC) 表示)。

UTCToday – 傳回目前的只有日期值 (以國際標準時間 (UTC) 表示)。

V

Validate – 檢查單一欄位或完整記錄值是否為有效的資料來源。

Value – 將字串轉換為數字。

VarP – 傳回其引數的變數。

ViewForm – 重設用於檢視現有項目的表單控制項。

W

Weekday – 擷取日期/時間值的星期幾部份。

WeekNum – 傳回日期/時間值的週數。

With – 針對單一記錄計算值並執行動作,包括具名值的內嵌記錄。

Y

Year – 擷取日期/時間值的年份部份。