Power Apps 的 Power Fx 公式參考
公式結合許多元素。 分列如下︰
- Functions 接受參數、執行運算然後傳回值。 例如,Sqrt(25) 傳回 5。 函數會在 Microsoft Excel 函數後建立模形。 有些函數會有副面效果,例如 SubmitForm 只適合 行為公式 (如 Button.OnSelect)。
- Signals 傳回環境相關資訊。 例如,Location 傳回裝置目前的 GPS 座標。 訊號不接受參數或有副面效果。
- 列舉 傳回預先定義的常數值。 例如,Color 是已預先定義 Color.Red、Color.Blue 等值的列舉。 常見列舉也一併納入;特定函數的列舉會和函數一同說明。
- 具名運算子,例如 ThisItem 和 Self,可從容器內存取資訊。
其他元素包括︰
A
Abs – 數字的絕對值。
Acceleration – 讀取裝置中的加速感應器。
Acos – 傳回數字的反餘弦值,單位為弧度。
Acot – 傳回數字的反餘切值,單位為弧度。
AddColumns – 傳回資料表,其中新增資料行。
And – 布林值邏輯 AND。 如果所有引數皆為 true,則傳回 true。 您也可以使用 && 運算子。
App – 提供目前所正在執行應用程式和對應用程式行為控制的相關資訊。
Asin – 傳回數字的反正弦值,單位為弧度。
Assert – 在測試中評估為 true 或 false。
As – 在資源庫、表單及記錄範圍函數中命名目前記錄,例如 ForAll、With 和 Sum。
AsType – 將記錄參考視為特定的資料表類型。
Atan – 傳回數字的反正切值,單位為弧度。
Atan2 – 依據 (x,y) 座標傳回反正切值,單位為弧度。
Average – 計算資料表運算式或一組引數的平均值。
B
Back – 顯示前一個畫面。
Blank – 傳回空白值,用來在資料來源中插入 NULL 值。
布林值 – 將文字字串、數字或非類型化值轉換為布林值。
C
Calendar – 擷取目前地區設定的行事曆相關資訊。
Char – 將字元碼轉譯成字串。
Choices – 傳回查閱欄位的可能值資料表。
ClearCollect – 刪除集合物件中的所有資料,然後新增一組記錄。
ClearData – 從應用程式主機 (例如本機裝置) 清除一個集合或所有集合。
Clock – 擷取目前地區設定的時鐘相關資訊。
Coalesce – 取代空白值,同時讓非空白值保持不變。
Collect – 建立集合物件或將資料新增至資料來源。
Color – 將屬性設定為內建色彩值。
ColorFade – 淡出色彩值。
ColorValue – 將 CSS 色彩名稱或十六進位碼轉譯為色彩值。
Compass – 傳回您的羅盤標題。
Concat – 串連資料來源中的字串。
Concatenate – 串連字串。
Concurrent – 同時彼此評估多個公式。
Connection – 傳回網路連線的相關資訊。
複製 - 在執行應用程式的裝置上將文字複製到剪貼簿。
Count – 計算包含數字的資料表記錄。
Cos – 傳回以弧度指定角度的餘弦值。
Cot – 傳回以弧度指定角度的餘切值。
CountIf – 計算符合條件的資料表記錄。
CountRows – 計算資料表記錄。
D
DataSourceInfo – 提供資料來源的相關資訊。
Date – 根據年、月、日值傳回日期/時間值。
DateAdd – 將日、月、季或年加入日期/時間值。
DateDiff – 將兩個日期值相減,並以天、月、季或年顯示結果。
DateTimeValue – 將日期和時間字串轉換成日期/時間值。
DateValue – 將僅有日期的字串轉換成日期/時間值。
Day – 擷取日期/時間值的日期部份。
Defaults - 傳回資料來源的預設值。
Degrees – 將弧度轉換成角度。
Disable – 停用信號,例如用於讀取 GPS 的位置。
Distinct – 摘要資料表的記錄,移除重複項目。
Download – 從網路下載檔案到本機裝置。
DropColumns – 傳回資料表,且其中移除一個或多個欄位。
E
EditForm – 重設表單中用於編輯項目的控制項。
EncodeUrl – 使用 URL 編碼將特殊字元編碼。
EndsWith – 檢查文字字串結尾是否為另一個文字字串。
Error – 建立自訂錯誤或傳遞錯誤。
Errors – 提供先前變更資料來源的錯誤資訊。
exactin – 檢查文字字串是否包含在另一個文字字串或表格中(區分大小寫)。 也用來檢查記錄是否在表格中。
Exit – 退出目前正在執行的應用程式並非必要地登出目前的使用者。
Exp - 傳回 e 的次方。
F
Filter – 根據一個或多個準則傳回篩選過的資料表。
Find – 檢查字串是否出現在另一個字串中,並傳回其位置。
First – 傳回資料表的第一筆記錄。
FirstN – 傳回資料表的第一組記錄 (N 筆記錄)。
ForAll – 計算值,並對資料表的所有記錄執行動作。
G
GroupBy – 傳回記錄已群組的資料表。
GUID – 將 GUID 字串轉換成 GUID 值或建立新 GUID 值。
H
HashTags – 從字串中擷取主題標籤 (#strings)。
主機 - 提供有關執行應用程式之目前主機的資訊。
Hour – 擷取日期/時間值的小時部份。
I
If – 如果條件成立則傳回一個值,不成立則傳回另一個值。
IfError - 偵測錯誤並提供替代值或採取動作。
in – 檢查文字字串是否包含在另一個文字字串或表格中(不區分大小寫)。 也用來檢查記錄是否在表格中。
Index – 根據排序位置從資料表傳回記錄。
Int - 將值向下捨入至最接近的整數。
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 – 傳回僅含選取欄位的資料表。
Shuffle – 隨機重新排列資料表的記錄。
Sin – 傳回以弧度指定角度的正弦值。
Sort – 傳回依據公式排序的資料表。
SortByColumns – 傳回依據一或多個欄位排序的資料表。
Split – 將文字字串分割成許多子字串。
Sqrt – 傳回數字的平方根。
StartsWith – 檢查文字字串的開頭是否為另一個文字字串。
StdevP – 傳回其引數的標準差。
Substitute – 以另一個字串取代字串的一部分,從符合子串開始。
SubmitForm – 將項目儲存在資料來源的表單控制項中。
Sum – 計算資料表運算式或一組引數的總和。
Switch – 與一組值比對,然後評估對應公式。
T
Table – 建立暫存資料表。
Tan – 傳回以弧度指定角度的正切值。
Text – 轉換任何值並將數字或日期/時間值格式化為文字字串。
ThisItem – 傳回資源庫或表單控制項中目前項目的記錄。
ThisRecord – 傳回記錄範圍函數中目前項目的記錄,例如 ForAll、With 和 Sum。
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 – 擷取日期/時間值的年份部份。