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 数据库生成的。