DataPerfect/函式

DataPerfect 函式
絕對值
語法	abs[arg]
相關函式
示例呼叫	abs[-5.73]
描述	Abs 用於獲取數字的絕對值（正值）（其中 arg = 任何 G 或 H 格式的數字）。
示例	abs[-1] -- 返回 1 abs[1] -- 返回 1 abs[45] -- 返回 45 abs[-45] -- 返回 45
將文字格式應用於數值
語法	apply.format[arg1;arg2]
相關函式	轉換
示例呼叫	apply.format["N9999";year[today]]
描述	Apply.format 用於將任何數值資料型別（格式 N、G、H、D 和 T）轉換為字母數字（格式 U 和 A）文字，其中 arg1 = 資料來源的欄位格式，arg2 = 要轉換的數值。
示例	如果 P1F1 是一個格式為“N(999)999-9999”的數值欄位，其值為 8003213249，則 apply.format["N(999)999-9999";P1F1] 將返回字串 "(801)321-3249"。
貝爾
語法	Bell[arg]
相關函式
示例呼叫	Bell[1]
描述	如果指定的值不為空或為 null，則 Bell 公式函式會發出蜂鳴聲。
示例	如果您有一個欄位用於標記過時的記錄（如果當前為空，如果過期則填充），並且您想驗證所有過時的記錄是否都已刪除，則可以執行一個報告來檢查該欄位，並在遇到該欄位中的任何內容時發出蜂鳴聲。如果所有記錄都是最新的，則在報告期間您不會聽到任何蜂鳴聲，但如果遺留了某些內容，則計算機將發出蜂鳴聲。
連線，不截斷
語法	cat.c[arg1;arg2;...;argn]
相關函式	cat.t
示例呼叫	cat.t[P1F1;1;apply.format["N99999";P1F5]]
描述	Cat.c 用於連線兩個或多個字串，而不截斷空格。引數可以是包含在引號（單引號 (') 或雙引號 (")）中的任何字串，包含字母數字資料的欄位/rv/公式，或指示要插入文字中的回車符數量的整數。
示例	如果 P1F1 = "Hello" 且 P1F2 = "There"，則 cat.c[P1F1;" ";P1F2;" This is a test!"] 將返回字串 "Hello There This is a test!"。
連線，截斷
語法	cat.t[arg1;arg2;...;argn]
相關函式	cat.c
示例呼叫	cat.t["This is a test";1;P1F1;rv0]
描述	Cat.t 用於連線兩個或多個字串，截斷空格。引數可以是包含在引號（單引號 (') 或雙引號 (")）中的任何字串，包含字母數字資料的欄位/rv/公式，或指示要插入文字中的回車符數量的整數。
示例	如果 P1F1 = "Hello " 且 P1F2 = "There "，則 cat.t[P1F1;" ";P1F2;"This is a test! "] 將返回字串 "HelloThereThis is a test!"。
包含
語法	contains[arg1;arg2]
相關函式
示例呼叫	contains[P1F2;"*DataPerfect*"]
描述	Contains 在字母數字和文字欄位中搜索指定的字串。Arg1 是要搜尋的欄位/rv/字串，arg2 是要搜尋的字串。如果搜尋成功，則返回整數 1；如果搜尋失敗，則返回 0。要搜尋的字串如果為硬編碼字串，則應包含在引號中；否則，搜尋字串可以來自報告變數或欄位。可以使用萬用字元（星號或問號）在欄位中的文字中查詢字串，否則要搜尋的字串必須是欄位中唯一的字串。
示例	如果 P1F1 = 字母數字或文字欄位，並且 "*sold*" 是搜尋字串，則 contains[P1F1;"*sold*"] 如果字串 "sold" 存在於 P1F1 中的任何位置，則返回 1（true），否則返回 0（false）。如果使用字串 "sold*"，則只有當字串存在於欄位的開頭時才會被找到。
將文字轉換為數字
語法	convert[arg1;arg2]
相關函式	apply.format
示例呼叫	convert["N9999";P1F1]
描述	Convert 用於將字串轉換為數字（G、H、T、D 或 N 格式）。Arg1 = 字串要轉換到的欄位格式，而 arg2 = 要轉換的字串值。
示例	如果 P1F1 是一個字母數字欄位，並且包含字串 "123456"，則 convert["G$ZZZ,ZZ9.99";P1F1] 將返回數值 123456.00（或在欄位中顯示為 $123,456.00）。
日期
語法	date[arg1;arg2;arg3]
相關函式	日期相關函式
示例呼叫	date[day[P1F1];month[today];yearrv1
描述	date 函式用於將表示日 (arg1)、月 (arg2) 和年 (arg3) 的三個數字組合成單個儒略日期值（自 1900 年 3 月 1 日以來的總天數）。
示例	如果函式 day[P1F1] 返回值為 19，並且 P1F2 包含值為 11，則 date[day[P1F1];P1F2;1992] 將返回 33,866 的值，或日期 1992.11.19。
日
語法	day[arg]
相關函式	day.of.week,month,year
示例呼叫	day[today]
描述	day 函式會返回儲存在 arg1 中的日期的月份中的天數（1 到 31 之間的數字），其中 arg1 是一個欄位、報表變數或 today 函式。
示例	如果 P1F1 是一個日期欄位，其值為 1992.11.19，那麼 day[P1F1] 將返回 19。
星期幾
語法	day.of.week[arg]
相關函式	day, month, year
示例呼叫	day.of.week[today]
描述	day.of.week 函式會返回儲存在 arg1 中的日期的星期幾（1 到 7 之間的數字，其中 1 = 星期一，7 = 星期日），其中 arg1 是一個欄位、報表變數或 today 函式。
示例	如果 P1F1 是一個日期欄位，其值為 1992.11.19，那麼 day.of.week[P1F1] 將返回 4（星期四）。
指數
語法	exp[arg]
相關函式
示例呼叫	exp[2]
描述	指數公式函式 (exp[x]) 會返回 x 的對數指數 (e^x)。
示例	exp[2] 返回 7.39（大約）。
本月第一天
語法	first.day[arg]
相關函式	date, last.day, first.nday
示例呼叫	first.day[P1F1]
描述	first.day 函式會返回任何給定月份的第一天的日期（在上面表示為“arg”，其中 arg = 一個具有日期格式的值）。
示例	如果 P1F1 是一個日期欄位，其值為 1992.11.19，那麼 first.day[P1F1] 將返回 1992.11.01（1992 年 11 月 1 日），即 1992 年 11 月的第一天。
本月第一個星期幾
語法	first.nday[arg1;arg2]
相關函式	date, first.day, last.day
示例呼叫	first.nday[7;P1F1]
描述	first.nday 函式會返回任何給定日期的第一個給定星期幾的日期（在上面表示為“arg1”），該日期由“arg2”表示。Arg1 = 1（星期一）到 7（星期日）之間的數字，表示一週中的幾天。Arg2 = 一個具有日期格式的值。
示例	如果 P1F1 是一個日期欄位，其值為 1992.11.19，那麼 first.nday[4;P1F1] 將返回 1992.11.05（1992 年 11 月 5 日），即本月的第一個星期四。
未來值
語法	fv[i;pv;pmt;n;type]
相關函式	pv, pmt, rate
示例呼叫	fv[(.08/12);-100;40;2;1]
描述	此函式會根據提供的資料返回未來值（利率、現值、付款金額、期數和型別（0 = 投資/增長或 1 = 折舊/貸款））。
示例	如果你有一筆 8% 的貸款，你的應付餘額為 100.00 美元，你每月支付 40.00 美元，並且你想知道你再支付 2 次後你的餘額是多少，你應該輸入 fv[.08/12);-100;40;2;1]; 你支付 2 次後的餘額將為 20.54 美元
首字母大寫
語法	icaps[text]
相關函式	Lower Case
示例呼叫	icaps[P2F3]
描述	將固定長度的字母數字欄位和開放式文字欄位中每個單詞的第一個字元大寫。
示例	icaps["hello jane"] 將返回 "Hello Jane" icaps["JOHN JONES"] 將返回 "JOHN JONES" icaps[lower.case["JOHN JONES"] 將返回 "John Jones"
本月最後一天
語法	last.day[arg]
相關函式	date, first.day, first.nday
示例呼叫	last.day[P1F1]
描述	last.day 函式會返回任何給定月份的最後一天的日期（在上面表示為“arg”，其中 arg = 一個返回日期值的欄位、報表變數或公式）。
示例	如果 P1F1 是一個日期欄位，其值為 1992.11.19，那麼 last.day[P1F1] 將返回 1992.11.30（1992 年 11 月 30 日），即 1992 年 11 月的最後一天。
本月最後一個星期幾
語法	last.nday[arg1;arg2]
相關函式	date, first.day, first.nday
示例呼叫	last.nday[7;P1F1]
描述	last.nday 函式會返回任何給定日期的最後一個給定星期幾的日期（在上面表示為“arg1”），該日期由“arg2”表示。Arg1 = 1（星期一）到 7（星期日）之間的數字，表示一週中的幾天。Arg2 = 一個具有日期格式的值。
示例	如果 P1F1 是一個日期欄位，其值為 11/19/92，那麼 last.nday[7;P1F1] 將返回 11/29/92（1992 年 11 月 29 日），即本月的最後一個星期日。
字串長度
語法	length[arg]
相關函式
示例呼叫	length["This is a test!"]
描述	Length 會返回一個數字，該數字等於任何給定字串在截斷尾部空格後的字元數。“Arg”可以是一個欄位、報表變數或返回字元字串的公式。length[arg] 的最大值為 78; 在使用 length[] 與文字欄位時，似乎存在一些問題。
示例	length["Arizona "] 返回 7。length["Ryan Davis"] 返回 10。
對數，自然對數
語法	ln[arg]
相關函式
示例呼叫	ln[11]
描述	對數公式函式 (ln[x]) 會返回指定數字的自然對數（x 以 e 為底的對數）。
示例	ln[11] 返回 2.4（大約）。
小寫
語法	lower.case[arg]
相關函式	Initial caps
示例呼叫	lower.case["LOWER CASE"]
描述	將固定長度的字母數字欄位和開放式文字欄位轉換為全小寫字元。
示例	lower.case["LOWER CASE"] 返回 "lower case"
最大值
語法	max[arg1;arg2;...argn]
相關函式	min
示例呼叫	max[P1F1;14;(3*7);rv0]
描述	Max 用於從一系列值（上面的“arg1”、“arg2”和“argn”）中提取最大值。引數可以是數字值或字串值，但不能在同一個函式中同時使用這兩種型別。Max 將提取具有最高值的引數的值。Max 不區分大小寫。
示例	max[sqrt[100];17;(4*3)] 將返回 17。 max["Ray";"Kevin";"Craig";"Christi";"Rick";"Jill"] 返回 "Rick"
最小值
語法	min[arg1;arg2;...argn]
相關函式	max
示例呼叫	min[P1F1;14;(3*7);rv0]
描述	Min 用於從一系列值（上面的“arg1”、“arg2”和“argn”）中提取最小值。引數可以是數字值或字串值，但不能在同一個函式中同時使用這兩種型別。Min 將提取具有最低值的引數的值。Min 不區分大小寫。
示例	min[sqrt[100];17;(4*3)] 將返回 10。 min["Ray";"Kevin";"Craig";"Christi";"Rick";"Jill"] 返回 "Christi"
模運算
語法	//
相關函式	round
示例呼叫	10 // 3
描述	返回除法方程式的餘數。
示例	10 // 4 - 返回 2 10 // 3 - 返回 1 10 // 2 - 返回 0
月份
語法	month[arg]
相關函式	day, day.of.week, year
示例呼叫	month[today]
描述	month 函式會返回儲存在 arg1 中的日期的月份編號（1（一月）到 12（十二月）之間的數字），其中 arg1 是一個欄位、報表變數或 today 函式。
示例	如果 P1F1 是一個日期欄位，其值為 1992.11.19，那麼 month[P1F1] 將返回 11（十一月）。
現在
語法	now
相關函式	today
示例呼叫	now
描述	Now 用於從計算機的內部時鐘中檢索系統時間（返回自 12a 後的秒數）。
示例	如果系統時間為 16:53:34（下午 4:53），那麼 now 將返回 60,814，或在時間 (T99:99:99) 格式的欄位中返回 16:53:34。
付款
語法	pmt[i;pv;n;fv;type]
相關函式	pv, fv, rate
示例呼叫	pmt[(.075/12);-4000;24;0;1]
描述	此函式會根據提供的資料返回你的付款金額（利息、現值、期數、未來值、型別（0 = 投資/增長或 1 = 折舊/貸款））。
示例	要了解你需要每月支付多少錢才能在 2 年內償還一筆 4000 美元的貸款，利率為 7.5，你應該輸入 pmt[(.075/12);-4000;24;0;1]（你需要每月支付 178.88 美元）。
冪
語法	^
相關函式	sqrt
示例呼叫	10^2
描述	將一個值提升到給定的指數冪。
示例	10^2 - 返回 100 10^3 - 返回 1000 10^4 - 返回 10000
現值
語法	pv[i;pmt;n;fv;type]
相關函式	pmt, fv, rate
示例呼叫	pv[(.06/12);0;240;500000;0]
描述	此函式根據提供的資料返回現值 [利率、付款金額、付款次數、尋求的未來值以及型別 (0=投資/增長或 1=折舊/貸款)]。
示例	要了解你需要存入多少資金到儲蓄賬戶，才能在 20 年後 (假設你保證獲得 6% 的利息) 不再存入任何資金的情況下在銀行賬戶中有 500,000 美元，你可以輸入 pv[(.06/12);0;240;500000;0]。你會發現，151,048.07 美元將在 20 年內以 6% 的利息增長到 500,000 美元。
利率
語法	Rate[pv;pmt;n;fv;type]
相關函式	pv, pmt, fv
示例呼叫	rate[-500;50;12;600;1]
描述	此函式根據提供的資料返回有效利率 [現值、付款金額；付款次數、未來值以及型別 (0=投資/增長或 1=折舊/貸款)]。
示例	要了解你在對一筆為期 12 個月的 500 美元貸款支付了 12 筆 50 美元的款項後所支付的利率，你需要輸入 rate[-500;50;12;600;1] (你支付了略高於 12% 的利息)。
舍入
語法	round[arg1;arg2]
相關函式	//
示例呼叫	round[P1F1;.25]
描述	將數字舍入到最接近的指示值，其中 arg1 = 要舍入的數值 (G 或 H 格式)，arg2 = 要舍入的值。
示例	round[4.5;1] - 返回 5。 round[54.123432;.001] - 返回 54.123 round[55.345;.25] - 返回 55.25 round[12347;50] - 返回 12350
平方根
語法	sqrt[arg]
相關函式	^ (冪)
示例呼叫	sqrt[(rv1*5)]
描述	計算一個數字的絕對值的平方根 (即如果數字為負數，則首先將其變為正數)，其中 arg = 要查詢平方根的數字 (G 或 H 格式) 欄位、報表變數、公式或值。
示例	sqrt[4] - 返回 2。 sqrt[65.3] - 返回 8.08。 sqrt[-65.3] - 返回 8.08。
子欄位
語法	subfield[arg1;arg2;arg3]
相關函式
示例呼叫	subfield[P1F1;" ";1]
描述	如果掩碼 (arg2) 為空或 " "，則在字串 (arg1) 中生成第 n 個單詞 (由 arg3 中的值確定)。生成第 n 個 (arg3) 單詞，該單詞由掩碼 (arg2) 中的任何字元括起來。
示例	subfield["Christine C. Babbitt";" ";2] 返回一個值為 "C." 的值。 subfield["(602) 123-4567";'- )(';1] 返回一個值為 "602" 的值。 (請注意，顯示的數字被視為文字，而不是 N、G 或 H 值。)
子字串
語法	substring[arg1;arg2;arg3]
相關函式	apply.format
示例呼叫	substring[P1F1;2;14]
描述	從字串中指定的位置開始返回文字字串中的指定數量的字元。(其中 arg1 = 要從中提取新字串的欄位、報表變數、公式或文字字串；arg2 = 要解析的起始位置；arg3 = 要從字串中剪切出的字元數)。 如果你為 arg2 輸入 1 或更大的值，DataPerfect 將從字串的左側開始計數，並從左到右計數。如果你為 arg2 輸入 0，DataPerfect 將從右到左計數字符。
示例	substring["Example";3;5] 將返回 "ample" 如果 P1F2 是一個格式化為 N(999)999-9999 的數值欄位，其值為 8003213249，那麼 substring[apply.format["N(999)999-9999";P1F2];2;3] 將返回 800 (區號)。 substring[" 215 Oak Lane, Hartford, CT";0;2] 此公式將返回字串 "CT"
期限
語法	term[i;pv;pmt;fv;type]
相關函式	pmt, pv, fv, rate
示例呼叫	term[(.05/12);0;165;-1000;0]
描述	此函式根據提供的資料返回週期數 (剩餘或預計) [利率、現值、付款金額、未來值以及型別 (0=投資/增長或 1=折舊/貸款)]。
示例	要了解你需要多長時間才能存到 1000 美元，如果你每月存入 165 美元並獲得 5% 的利息 (並從零餘額開始)，你需要輸入 term[(.05/12);0;165;-1000;0)] (你將在 6 個月內獲得略高於 1000 美元)。
今天
語法	today
相關函式	now
示例呼叫	today
描述	Today 返回系統日期 (來自計算機的內部時鐘) 的儒略日期格式 (即自 1900 年 3 月 1 日以來的天數。當儲存在日期欄位格式中時，此數字將自動轉換為相應的月/日/年。today 函式通常用作其他函式和公式中的引數。
示例	如果系統日期為 1992 年 11 月 11 日，那麼 today 將返回 33,866，或者在日期 (DYMD9999.99.99) 格式化的欄位中返回 1992.11.19。
截斷
語法	truncate[arg]
相關函式	cat.t
示例呼叫	truncate[P1F1]
描述	Truncate 刪除字元字串中所有尾隨空格。
示例	truncate["Shauna         "] 將返回 "Shauna." 可以使用連續的 truncate 函式 (例如 truncate[P1F2] truncate[P1F3]) 來建立文字字串，但通常最好使用 cat.t 函式。
一元負號
語法	-
相關函式
示例呼叫	-P1F1
描述	返回任何數字的負值。
示例	如果 P1F1 = 10，那麼 -P1F1 返回 -10。 如果 today = 1992.11.19，那麼 -today 返回 -33,866。 (這適用於將最新日期的記錄排序到列表的頂部。請參閱此資料庫的公式部分中的 "反轉日期"。)
年份
語法	year[arg]
相關函式	day, day.of.week, month
示例呼叫	year[P1F1]
描述	Year 從日期值中返回 4 位數的年份 (例如 1992) 的數字格式。
示例	如果 P1F1 是一個值為 1992.11.19 的日期欄位，那麼 year[P1F1] 將返回數值 1992，然後可以將其儲存在 N9999 欄位中。 一些其他可接受的格式包括以下內容：year[rv1]、year[date[19;11;1992]] 和 year[today]。
源註釋 此維基頁面是從 DataPerfect FORMULA 資料庫生成的。