函数:快速参考
以下类型的函数可用于转换数据。数据类型决定可使用的函数。如需了解详情,请参阅数据类型。
通过本指南,您可以快速参阅 Designer 中表达式编辑器使用的函数。如果您需要更多信息和示例,请参阅具体函数类别的页面,页面链接可在每个部分中找到。
自定义公式函数
如果您使用自定义公式函数,并且您的自定义函数与现有 Alteryx 函数(或新引入的 Alteryx 函数)同名,则可能会遇到意外结果和冲突。
要解决此问题,请重命名您的自定义函数(或添加前缀/后缀)以将其与基础版本安装的 Designer 函数区分开来。
条件
条件函数允许您使用 IF 语句执行操作或计算。如需参数和示例,请参阅条件函数一文。
IF c THEN t ELSE f ENDIF
IF c THEN t ELSE f ENDIF
:如果条件 c 为 true,则返回 t;否则,返回 f。
IF c THEN t ELSEIF c2 THEN t2 ELSE f ENDIF
IF c THEN t ELSEIF c2 THEN t2 ELSE f ENDIF
:如果第一个条件 c 为 true,则返回 t;否则,如果第二个条件 c2 为 true,则返回 t2;否则,返回 f。
IIF
IIF(bool, x, y)
:如果布尔值为 true,则返回 x,否则返回 y。
Switch
Switch(Value,Default,Case1,Result1,...,CaseN,ResultN)
:将值与一系列条件进行比较,并返回相应的结果。
转换
转换函数将数字转换为字符串或者将字符串转换为数字。如需参数和示例,请参阅转换函数一文。
BinToInt
BinToInt(s)
:将二进制字符串 s 转换为整数(限制为 53 位)。
CharFromInt
CharFromInt(x)
:返回与输入数字 x 相匹配的 Unicode® 字符。
CharToInt
CharToInt(s)
:返回与输入 Unicode® 字符 s 相匹配的数字。
ConvertFromCodePage
ConvertFromCodePage(s, codePage)
:将文本从代码页转换为 Unicode 编码。如需详细了解代码页,请参阅代码页文档。
ConvertToCodePage
ConvertToCodePage(s, codePage)
:将文本从 Unicode® 编码转换为特定代码页。如需详细了解代码页,请参阅代码页文档。
HexToNumber
HexToNumber(x)
:将十六进制字符串转换为数字(限制为 53 位)。
IntToBin
IntToBin(x)
:将 x 转换为二进制字符串。
IntToHex
IntToHex(x)
:将 x 转换为十六进制字符串。
ToDegrees
ToDegrees(x)
:通过 (x)rad × 180/π 计算将数值弧度值 (x) 转换为度数。请注意,x 必须是一个数值,不能包含任何弧度符号 (rad)。
ToNumber
ToNumber(x, [bIgnoreErrors], [keepNulls], [decimalSeparator])
:将字符串 (x) 转换为数字。
ToRadians
ToRadians(x)
:通过 (x)° × π/180 计算,将数值度数值 (x) 转换为弧度值。请注意,x 必须是一个数值,不能包含度数符号 (°)。
ToString
ToString(x, numDec, [addThousandsSeparator], [decimalSeparator])
:使用小数位数参数 numDec 将数值参数 (x) 转换为字符串。默认选项使用句点作为小数分隔符。
UnicodeNormalize
UnicodeNormalize(String, Form)
: Converts text data in the provided string into a standardized Unicode form. Use the required Form parameter (case-insensitive) to define the normalization form.
日期时间
日期时间函数允许您对日期和时间值执行操作或计算。如需参数和示例,请参阅日期时间函数一文。
DateTimeAdd
DateTimeAdd(dt,i,u)
:: 将一个具体时间间隔添加到日期时间值中。
DateTimeDay
DateTimeDay(dt)
:返回日期时间值中月份日期的数字值。
DateTimeDiff
DateTimeDiff(dt1,dt2,u)
:第一个参数减去第二个参数,并返回它们之间的整数差值。时间间隔以指定时间单位为单位返回一个数字,而不是返回字符串。
DateTimeFirstOfMonth
DateTimeFirstOfMonth()
:返回每月的第一天(午夜时间)。
DateTimeFormat
DateTimeFormat(dt,f,l)
:以指定语言 (l),将日期时间数据从 ISO 格式转换为其他指定格式 (f),以用于其他应用。输出为字符串数据类型。如果指定格式的精度较低,则输出会被截断。
DateTimeHour
DateTimeHour(dt)
:返回日期时间值中小时部分的值。
DateTimeLastOfMonth
DateTimeLastOfMonth()
:返回当月的最后一天,时钟设置为一天结束前一秒的时间 (23:59:59)。
DateTimeMinutes
DateTimeMinutes(dt)
:返回日期时间值中分钟部分的值。
DateTimeMonth
DateTimeMonth(dt)
:返回日期时间值中月份的数字值。
DateTimeNow
DateTimeNow()
:返回当前系统日期和时间,具体到秒。
DateTimeNowPrecise
DateTimeNowPrecise()
:返回当前系统日期和时间,具体到秒后的小数,最多支持 18 位精度。请注意,如果您请求的精度超出操作系统提供的精度,则该函数将用零填充其余部分。
DateTimeParse
DateTimeParse(dt,f,l)
:将指定格式 (f) 和指定语言 (l) 的日期字符串转换为标准 ISO 格式(yyyy-mm-dd HH:MM:SS,如果适用,还可以满足可选的日期时间精度要求)。如果指定格式的精度较低,则输出会被截断。
DateTimeQuarter
DateTimeQuarter(dt, [Q1 Start])
:返回日期时间 (YYYY-MM-DD) 值所在年份的季度数值。使用可选的数字参数 (1-12) 表示 Q1 的起始月份。
DateTimeSeconds
DateTimeSeconds(dt)
:返回日期时间值中的秒数部分,包括任何亚秒级精度(如果适用)。
DateTimeStart
DateTimeStart()
:返回当前工作流开始运行的日期和时间。
DateTimeToday
DateTimeToday()
:返回今天的日期。
DateTimeToLocal
DateTimeToLocal(dt)
:将 UTC 日期时间转换为本地系统时区。DateTimeToLocal 函数目前不支持 dt
字段中的日期时间精度。
DateTimeToUTC
DateTimeToUTC(dt)
:将日期时间(在本地系统时区)转换为 UTC。DateTimeToUTC 函数目前不支持 dt
字段中的日期时间精度。
DateTimeTrim
DateTimeTrim(dt,t)
:删除日期时间中不需要的部分,并返回修改后的日期时间。
DateTimeYear
DateTimeYear(dt)
:返回日期时间值中年份的数字值。
ToDate
ToDate(x)
:将字符串、数字或日期时间转换为日期。
ToDateTime
ToDateTime(x)
:将字符串、数字或日期转换为日期时间。ToDateTime 函数不支持日期时间精度。Excel 值应限制以秒表示(5 位,最多为 99999)。
文件
文件函数生成文件路径,检查文件是否存在,或提取文件路径的一部分。如需参数和示例,请参阅文件函数一文。
FileAddPaths
FileAddPaths(Path1, Path2)
:添加文件路径的两个部分,确保两个路径之间只有一个 \(反斜杠)。
FileExists
FileExists(Path)
:如果文件存在,则返回 True
;如果不存在,则返回 False
。
FileGetDir
FileGetDir(Path)
:返回路径的目录部分。
FileGetExt
FileGetExt(Path)
:返回路径扩展名,包括“.”(句点)。
FileGetFileName
FileGetFileName(Path)
:返回路径的名称部分,不含扩展名。
金融
金融函数应用金融算法或数学计算。在金融函数一文中了解更多信息。
FinanceCAGR
FinanceCAGR(BeginningValue, EndingValue, NumYears)
:计算复合年增长率:按年计算的几何平均增长率。
FinanceEffectiveRate
FinanceEffectiveRate(NominalRate, PaymentsPerYear)
:计算有效年利率:贷款或金融产品的利率,由名义利率重述为年复利利率,以拖欠方式支付。
FinanceFV
FinanceFV(Rate, NumPayments, PaymentAmount, PresentValue, PayAtPeriodBegin)
:计算投资的未来价值:假设以特定的利率或收益率,资产在未来指定时间的价值。
FinanceFVSchedule
FinanceFVSchedule(Principle, Year1Rate, Year2Rate)
:计算未来价值表:对投资应用一系列利率后初始本金的未来价值。
FinanceIRR
FinanceIRR(Value1, Value2)
:计算内部收益率:即通过投资成本产生投资收益时的利率。这意味着从投资中获得的所有收益本质上是货币时间价值,并且在该利率下投资的净现值为零。
FinanceMIRR
FinanceMIRR(FinanceRate, ReinvestRate, Value1, Value2)
:计算修正内部收益率:内部收益率的修正,旨在解决内部收益率 (IRR) 的一些问题。MIRR 是衡量投资吸引力的金融指标。
FinanceMXIRR
FinanceMXIRR(FinanceRate, ReinvestRate, Value1, Date1, Value2, Date2)
:计算投资指定日期内的修正内部收益率。
FinanceNominalRate
FinanceNominalRate(EffectiveRate, PaymentsPerYear)
:计算名义年利率:如果复合频率(如一个月)与基本时间单位(通常为一年)不相同,则将利率称为名义利率。
FinanceNPER
FinanceNPER(Rate, PaymentAmount, PresentValue, FutureValue, PayAtPeriodBegin)
:计算投资或贷款的期数。
FinanceNPV
FinanceNPV(Rate, Value1, Value2)
:计算投资的净现值:以现值计算满足融资费用时现金流量的超额或短缺额。
FinancePMT
FinancePMT(Rate, NumPayments, PresentValue, FutureValue, PayAtPeriodBegin)
:计算贷款的还款额。
FinancePV
FinancePV(Rate, NumPayments, PaymentAmount, FutureValue, PayAtPeriodBegin)
:计算投资的现值:为反映货币的时间价值和投资风险等其他因素而经过折现的一笔未来付款或一系列未来付款在给定日期的价值。
FinanceRate
FinanceRate(NumPayments, PaymentAmount, PresentValue, FutureValue, PayAtPeriodBegin)
:计算利率(每期)。
FinanceXIRR
FinanceXIRR(Value1, Date1, Value2, Date2)
:计算投资在指定日期的内部收益率。
FinanceXNPV
FinanceXNPV(Rate, Value1, Date1, Value2, Date2)
:计算投资在指定日期的净现值。
数学
数学函数执行数学计算。如需参数和示例,请参阅数学函数一文。
ABS
ABS(x)
:返回 (x) 的绝对值。这是某数字和零的距离。该值始终为正。
ACOS
ACOS(x)
:返回 (x) 的反余弦。
ASIN
ASIN(x)
:返回 (x) 的反正弦值。
ATAN
ATAN(x)
:返回 (x) 的反正切值。
ATAN2
ATAN2(y, x)
:返回 y 和 x 的反正切值((y/x) 的反正切值)。
Average
Average(n1, ...)
:返回一组数字的平均值。
AverageNonNull
AverageNonNull(n1, ...)
:返回一组数字的平均值。计算中不包括 Null 值。该计算仅适用于数字类型的数据。
CEIL
CEIL(x, [mult])
:返回一个数值 (x),该值在满足大于或等于 x 的同时,应为 (mult) 的最小倍数。参数 (mult) 必须是大于 0 的数字。如果未指定 (mult),则函数返回大于或等于 (x) 的最小整数。
COS
COS(x)
:返回 (x) 的余弦。
COSH
COSH(x)
:返回 (x) 的双曲余弦值。
DISTANCE
DISTANCE(from_Lat,from_Lon, to_Lat, to_Lon)
:返回 (lat1,lon1) 与 (lat2,lon2) 之间的距离。
EXP
EXP(x)
:返回自然对数 e 的 x 次幂 (e^x)。
FACTORIAL
FACTORIAL(x)
:通过 (n!= n x (n-1) x … x 1) 计算返回数值 (x) 的阶乘。例如,4 的阶乘计算如下:4! = 4 x 3 x 2 x 1 = 24。
FLOOR
FLOOR(x, [mult])
:返回一个数值 (x),该值在满足小于或等于 x 同时,应为 (mult) 的最大倍数。参数 (mult) 必须是大于 0 的数字。如果未指定 (mult),函数将返回小于或等于 (x) 的最大整数,如下面第一个示例所示。
LOG
LOG(x)
:返回 (x) 的自然对数。
LOG10
LOG10(x)
:返回 (x) 以 10 为底的对数。
Median
Median(...)
:计算一个或多个(可能未排序)值的中值。
Mod
Mod(n,d)
:用 (d) 除以(n) 的余数(整数运算)。
PI
PI()
:返回 15 位精度的常量 PI(圆周率)的值。
POW
POW(x, e)
:返回 (x) 的 (e) 次幂。
RAND
RAND()
:返回一个大于或等于 0 且小于 1 的随机数。
RandInt
RandInt(n)
:返回 0 和指定参数之间的一个随机整数。
Round
Round(x, mult)
:返回四舍五入到最接近 (mult) 倍数的 (x)。
SIN
SIN(x)
:返回 (x) 的正弦。
SINH
SINH(x)
:返回 (x) 的双曲正弦值。
SmartRound
SmartRound(x)
:返回 (x) 四舍五入后最接近根据 (x) 大小动态决定的某数字倍数的值。
SQRT
SQRT(x)
:返回 (x) 的平方根。
TAN
TAN(x)
:返回 (x) 的正切。
TANH
TANH(x)
:返回 (x) 的双曲正切值。
数学:位操作
按位函数是对位模式或二进制数的一元和二元操作。使用按位函数对值进行比较和计算。如需参数和示例,请参阅数学:按位函数一文。
BinaryAnd
BinaryAnd(n,m)
:返回 (n) 和 (m) 的二进制数。如果 n 和 m 均为 1,则结果为 1,否则为 0。如果 0 与 false 相等,而 1 与 true 相等,则 BinaryAnd 运算的工作方式与逻辑 And 运算类似。
BinaryNot
BinaryNot(n)
:返回 (n) 的二进制取反。
BinaryOr
BinaryOr(n,m)
:返回 (n) 和 (m) 的二进制或 (OR)。
BinaryXOR
BinaryXOr(n,m)
:返回 (n) 和 (m) 的 Binary XOr。
ShiftLeft
ShiftLeft(n,b)
:将 (n)(整数)左移 (b) 位。
ShiftRight
ShiftRight(n,b)
:将 (n)(整数)右移 (b) 位。
最小值/最大值
最小值/最大值函数查找一组值的最小和最大值。如需参数和示例,请参阅最小值/最大值函数一文。
Between
BETWEEN(x, min, max)
:测试一个值 (x) 是否介于两个其他值(最小值和最大值)之间,包含最小值和最大值。如果 x 介于最小值和最大值之间,则返回 TRUE。如果 x 未介于最小值和最大值之间,则返回 FALSE。
Bound
Bound(x, min, max)
:如果 (x < min),则返回 min;否则,如果 (x > max),则返回 max;否则,返回 (x)。
Max
Max(v0, v1, ..., vn)
:返回列表中的最大值。
MaxIDX
MaxIDX(v0, v1,..., vn)
:返回列表中最大值的索引(从 0 开始)。
Min
Min(v0, v1,..., vn)
:返回列表中的最小值。
MinIDX
MinIDX(v0, v1,..., vn)
:返回列表中最小值的索引(从 0 开始)。
运算符
运算符是代表一个操作的字符。使用算术运算符执行数学计算,使用布尔运算符处理真/假 (true/false) 值。在运算符一文中了解更多信息。
注释块
/*Comment*/
:使用注释块运算符可在表达式编辑器(在表达式行内)添加注释块,而不干扰表达式。
单行注释
// Comment
:使用单行注释运算符可在表达式编辑器中添加一行注释,而不干扰表达式。
Boolean AND &&
Boolean AND &&
:(布尔值 AND)使用此运算符可组合 2 个布尔值。其结果也是一个布尔值。如果两个组合值都为 true,则结果为 True;如果组合值中的任何一个值为 false,则结果为 False。
Boolean AND - 关键字
Boolean AND - 关键字
:(布尔值 AND)使用此运算符可组合 2 个布尔值。其结果也是一个布尔值。如果两个组合值都为 true,则结果为 True;如果组合值中的任何一个值为 false,则结果为 False。
Boolean NOT !
Boolean NOT !
:(布尔值 NOT)接受一个输入。如果输入为 true,则返回 False。如果输入为 false,则返回 True。
Boolean NOT - 关键字
Boolean NOT - 关键字
:(布尔值 NOT)接受一个输入。如果输入为 true,则返回 False。如果输入为 false,则返回 True。
Boolean OR - 关键字
Boolean OR - 关键字
:(Boolean OR)如果两个值中的一个或两个为 true,则返回 True。
Boolean OR ||
Boolean OR ||
:(Boolean OR)如果两个值中的一个或两个为 true,则返回 True。
右括号
右括号 )
:右括号。
除
除法 /
:使用除法运算符将一个数值除以另一个数值。
等于
Equal To =
:等于。
大于
Greater Than >
:大于。
大于或等于
Greater Than Or Equal >=
:大于或等于。
小于
小于 <
:小于。
小于或等于
Less Than Or Equal <=
:小于或等于。
乘
Multiplication *
:使用乘法运算符可将多个数值相乘。
不等于
Not Equal To !=
:不等于。
左括号
Open Parenthesis (
:左括号。
减
减 -
:使用减法运算符可从一个数值中减去另一个数值。
值 IN - 关键字
value IN (...) - 关键字
:(测试值存在于列表中)确定给定值是否与子查询或列表中的任何值匹配。
Value NOT IN - 关键字
value NOT IN (...) - 关键字
:(测试值不在列表中)确定给定值是否与不在子查询或列表中的任何值匹配。
空间
空间函数生成空间对象、分析空间数据并从空间字段返回度量值。如需参数和示例,请参阅空间函数一文。
ST_Area
ST_Area(object, units)
:以指定单位返回空间对象面积(数值数据)。
ST_Boundary
ST_Boundary(object)
:返回空间对象边界(折线空间对象代表输入多边形的边界)。
ST_BoundingRectangle
ST_BoundingRectangle(object, ...)
:返回空间对象的矩形边框(多边形空间对象)。
ST_Centroid
ST_Centroid(object)
:返回空间对象的形心(点空间对象)。
ST_CentroidX
ST_CentroidX(object)
:返回空间对象形心的经度(数值数据)。
ST_CentroidY
ST_CentroidY(object)
:返回空间对象形心的纬度(数值数据)。
ST_Combine
ST_Combine(object1, object2,...)
:组合空间对象(空间对象)。
ST_Contains
ST_Contains(object1,object2)
:如果 object1 包含 object2,则返回 True(布尔值)。
ST_ConvexHull
ST_ConvexHull(object1,...)
:返回空间对象的凸包(空间对象)。
ST_CreateLine
ST_CreateLine(point1, point2...)
:按顺序连接指定的点和线以创建线条(空间对象)。
ST_CreatePoint
ST_CreatePoint(x,y)
:返回包含指定经度和纬度坐标的空间对象(空间对象)。
ST_CreatePolygon
ST_CreatePolygon(obj1, obj2...)
:按顺序连接指定的点和线以创建多边形(空间对象)。
ST_Cut
ST_Cut(object1,object2)
:返回从 object2 中剪去 object1 的结果(空间对象)。
ST_Dimension
ST_Dimension(object)
:返回空间对象的维度空间维度是指构建空间对象的点所需的最小坐标数目(数值数据)。
点对象返回值 0。
线对象返回值 1。
多边形对象返回值 2
ST_Distance
ST_Distance(object1, object2, units)
:以指定的单位返回 object1 与 object2 之间的距离。支持的单位有英里 (Mi)、公里 (KM)、米和英尺(数值数据)。
ST_EndPoint
ST_EndPoint(object)
:返回空间对象的最后一个点(点空间对象)。
ST_Intersection
ST_Intersection(object1, object2, ...)
:返回指定空间对象的交集(空间对象)。
ST_Intersects
ST_Intersects(object1, object2...)
:如果空间对象产生交集,则返回 True(布尔值)。
ST_InverseIntersection
ST_InverseIntersection(object1, object2...)
:返回指定空间对象的逆交集(空间对象)。
ST_Length
ST_Length(object, units)
:以指定的单位返回空间对象的线性长度(数值数据)。
ST_MD5
ST_MD5(object)
:计算空间对象的 MD5 哈希值。
ST_MaxX
ST_MaxX(object)
:返回空间对象的最大经度(数值数据)。
ST_MaxY
ST_MaxY(object)
:返回空间对象的最大纬度(数值数据)。
ST_MinX
ST_MinX(object)
:返回空间对象的最小经度(数值数据)。
ST_MinY
ST_MinY(object)
:返回空间对象的最小纬度(数值数据)。
ST_NumParts
ST_NumParts(object)
:返回空间对象组件的数量(数值数据)。
ST_NumPoints
ST_NumPoints(object)
:返回空间对象的点数(数值数据)。
ST_ObjectType
ST_ObjectType(object)
:返回空间对象类型的字符串值(字符串数据)。
ST_PointN
ST_PointN(object, n)
:返回空间对象中的第 N 个点(点空间对象)。
ST_RandomPoint
ST_RandomPoint(object)
:返回空间对象中的一个随机点(点空间对象)。
ST_Relate
ST_Relate(object1,object2,relation)
:如果对象满足所提供的 DE-9IM 关系,则返回 True(布尔值)。
ST_StartPoint
ST_StartPoint(object)
:返回空间对象的第一个点(空间对象)。
ST_Touches
ST_Touches(object1, object2)
:如果 object1 与 object2 相接,则返回 True(布尔值)。
ST_TouchesOrIntersects
ST_TouchesOrIntersects(object1, object2)
:如果 object1 与 object2 相接或相交,则返回 True(布尔值)。
ST_Within
ST_Within(object1, object2)
:如果 object2 包含 object1,则返回 True(布尔值)。
特殊函数
这些函数执行各种特殊操作,可以与所有数据类型一起使用。如需参数和示例,请参阅特殊函数一文。
Coalesce
Coalesce(v1,v2,v3,…,vn)
:返回第一个非 null 值。
EscapeXMLMetacharacters
EscapeXMLMetacharacters(String)
:使用 XML 元字符的转义版本来替换这些字符。有 5 个字符可转义。
字符 | 转义版本 |
---|---|
" | " |
' | ' |
< | < |
> | > |
& | & |
GetVal
GetVal(index, v0,...vn)
:返回索引(从 0 开始)对应的 (v0, ..., vn) 值。
GetEnvironmentVariable
GetEnvironmentVariable(Name)
:返回 Name 中指定的环境变量。要获取环境变量列表,请在计算机上转至控制面板>系统和安全>系统>高级系统设置>环境变量。您将看到系统变量列表。您可以使用此列表中的任何值。
Server 支持
Alteryx 不支持保存至 Server 的应用程序中的 GetEnvironmentVariable
。
消息
Message(messageType, message, returnValue)
:与条件语句一起用于将消息输出到消息日志,并在满足条件时使用指定值更新列数据。
NULL
NULL()
:返回 Null 值。
RangeMedian
RangeMedian(...)
:计算一系列汇总范围的中位数。如需了解详情,请访问范围中位数。
ReadRegistry
ReadRegistryString(Key, ValueName, DefaultValue=")
:返回注册表中的值。
Soundex
Soundex(String)
:返回字符串的 Soundex 码。Soundex 基于字符串中的第一个字符加上基于以下项的三个字符创建代码:
字符 | Soundex |
---|---|
非字母字符(数字和标点符号) | -1 |
a、e、i、o、u、y、h 和 w | 除非它是字符串中的第一个字符,否则将被忽略。 |
b、f、p 和 v | 1 |
c、g、j、k、q、s、x 和 z | 2 |
d 和 t | 3 |
l | 4 |
m 和 n | 5 |
r | 6 |
Soundex_Digits
Soundex_Digits(String)
:返回前 4 个数字;或者,如果无,则返回 Soundex 码。
如果字符串中有数字,则返回前 4 位数字。
如果没有数字,则返回 Soundex 代码。
TOPNIDX
TOPNIDX(N, v0, v1, ..., vn)
:返回列表中第 n 个最大值的索引(从 0 开始)。当 N==0 时,等同于 MaxIdx(...)。
UrlEncode
UrlEncode(String)
:将 UTF-16 字符串编码为适用于原始引擎和 AMP 的 Web 合法 URL。
UrlEncodeUTF8
UrlEncodeUTF8(String)
: Encodes a string using the RFC 3986-compliant percent-encoding.
字符串
字符串函数对文本数据执行操作。使用字符串函数清理数据、将数据转换为其它格式或大小写、对数据进行度量计算或执行其它操作。如需参数和示例,请参阅字符串函数一文。
包含
Contains(String, Target, CaseInsensitive=1)
:在一个字符串中搜索某一字符串的匹配项。如果字符串 (String) 包含目标 (Target),则返回 True,否则返回 False。
CountWords
CountWords(string)
:返回指定字符串中的字数。字由空格分隔的字符定义。
DecomposeUnicodeForMatch
DecomposeUnicodeForMatch(String)
:转换为窄字符同时,删除重音并扩展复合字符。此函数提取 Unicode 字符串并将其转换为小写的窄字符字符串。移除所有重音符号和其它修饰。
EndsWith
EndsWith(String, Target, CaseInsensitive=1)
:检查字符串是否以特定的字符串结尾。如果 (String) 以 (Target) 结尾,则返回 True;否则,返回 False。默认行为不区分大小写。
FindNth
FindNth(Initial String, Target, Instance)
:在初始字符串中查找目标字符串的实例(第 n 次出现),并返回实例的位置(从 0 开始编入索引)。该函数区分大小写,而且不接受负参数。
FindString
FindString(String,Target)
:搜索一个字符串 (String) 中特定字符串 (Target) 的匹配项,并返回特定字符串在字符串中的数字位置。返回字符串 (String) 中首个目标 (Target) 的索引(从 0 开始)。如果不存在匹配项,则返回 -1。
GetLeft
GetLeft(String, Delimiter)
返回首次出现指定的 1 个或多个分隔符 (Delimiter)字符串 (String) 的左侧部分。
GetPart
GetPart(String, Delimiter, Index)
使用指定的 1 个或多个分隔符,将字符串 (String) 划分为多个子字符串,并返回索引 (Index) 中指定位置的子字符串。例如,如果索引为 2,则函数会返回第二个子字符串。
GetRight
GetRight(String, Delimiter)
返回所提供的字符串 (String) 的右侧部分,直到首次出现指定的 1 个或多个分隔符为止。
GetWord
GetWord(string, n)
:返回字符串中的第 N 个(索引从 0 开始)单词。字指的是由空格分隔的字符集合。索引从 0 开始,表示第一个字位于 0 位置。
Left
Left(String, len)
:返回字符串 (String) 中最左边长度为 (len) 的字符。如果 len 小于 0 或大于字符串 (String) 的长度,则字符串保持不变。
Length
Length(String)
:返回字符串 (String) 的长度。
LowerCase
LowerCase(String)
:将字符串转换为小写。
MD5_ASCII
MD5_ASCII(String)
:计算字符串的 MD5 哈希值。字符串仅限为窄字符。在计算哈希值之前会将宽字符转换为“?”。用于字符串类型,不建议用于 WString 类型。您应该避免在可能包含宽字符的字符串上使用此函数。
MD5_UNICODE
MD5_UNICODE(String)
:在原始引擎或 AMP 中,计算存储为 UTF-16 的字符串的 MD5 哈希值。
MD5_UTF8
MD5_UTF8(String)
:计算存储为 UTF-8 的字符串的 MD5 哈希值。
PadLeft
PadLeft (String, len, char)
:将指定字符向字符串的左边填充,直到字符串达到指定的长度。如果用于填充的字符 (char) 包含一个以上的字符,则仅使用第一个字符。
PadRight
PadRight (String, len, char)
:将指定字符向字符串的右边填充,直到字符串达到指定的长度。如果用于填充的字符 (char) 包含一个以上的字符,则仅使用第一个字符。
REGEX_CountMatches
REGEX_CountMatches(String,pattern,icase)
:返回字符串中与模式匹配的项计数。
REGEX_Match
REGEX_Match(String,pattern,icase)
:搜索字符串中正则表达式的匹配项。判断字符串是否从第一个字符到最后一个字符与模式匹配。
REGEX_Replace
REGEX_Replace(String, pattern, replace, icase)
:允许使用正则表达式替换文本,返回由正则表达式查找 (pattern) 和替换 (string) 生成的字符串。所有匹配项都将被替换,而不仅仅是第一项。
替换
Replace(String, Target, Replacement)
:使用字符串 (Replacement) 替换出现的每一个字符串 (Target),再返回字符串 (String)。
替换字符
ReplaceChar(String, y, z)
:使用字符 (z) 替换字符 (y) 的每个匹配项后返回字符串 (String)。如果替换字符 (z) 具有一个以上的字符,则只使用第一个字符。如果 (z) 为空,则每个与 (y) 中的任何一个字符匹配的字符 (String) 将被删除。
ReplaceFirst
ReplaceFirst(String, Target, Replacement)
:使用字符串 (Replacement) 替换字符串 (Target) 的第一个匹配项后,返回字符串 (String)。
ReverseString
ReverseString(String)
:反转字符串中的所有字符。
Right
Right(String, len)
:返回字符串的最后 (len) 个字符。如果 len 小于 0 或大于 String 的长度,则字符串保持不变。
StartsWith
StartsWith(String, Target, CaseInsensitive=1)
:检查字符串是否以指定的字符串开头。如果字符串 String 以指定字符串 Target 开头,则返回 True,否则返回 False。
STRCSPN
STRCSPN(String, y)
:返回字符串 (String) 开头连续的、不含字符串 (y) 中字符的字符串长度。
StripQuotes
StripQuotes(String)
:删除字符串结尾的一组成对的引号或单引号。
STRSPN
STRSPN(String, y)
:返回由字符串 (y) 中的字符组成的字符串 (String) 的初始段的长度。
Substring
Substring(String, start, length)
:返回字符串 (String) 从 (start) 位置开始提取长度等于 (length) 的子字符串(如果提供了长度)。
TitleCase
TitleCase(String)
:将字符串转换为词首字母大写。
Trim
Trim(String, y)
:删除字符串 (String) 尾部出现的字符串 (y) 中的字符。Y 是可选项,默认为去掉空白。提示:在 TRIM 函数示例中,指定的字符将被去掉。字符顺序不重要。
TrimLeft
TrimLeft(String, y)
:删除字符串 (String) 开头出现的字符串 (y) 中的字符。Y 是可选项,默认为去掉空白。
TrimRight
TrimRight(String, y)
:删除字符串 (String) 尾部出现的字符串 (y) 中的字符。Y 是可选项,默认为去掉空白。
Uppercase
Uppercase(String)
: 将字符串转换为大写。
Uuid
UuidCreate()
:创建唯一标识符。
测试
测试函数执行数据比较。使用测试函数识别值的数据类型,或确定某个值是否存在。如需参数和示例,请参阅测试函数一文。
CompareDictionary
CompareDictionary(a,b)
:比较 2 个字符串,忽略大小写差异,并比较由数字组成的文本(按数字顺序)。如果 a < b,则函数返回 -1;如果 a==b;则返回 0;如果 a > b,则返回 1。
CompareDigits
CompareDigits(a, b, nNumDigits)
:比较 2 个数字并确定它们是否与给定的位数 (nNumDigits) 相同。此比较函数先找到数字之间的差值,当差值的首个有效数字位于 A 和 B 中较大数字的首个有效数字右侧 NumDigits 位数或更多位数时,函数就报告 A 和 B 相同。
CompareEpsilon
CompareEpsilon(a, b, epsilon)
:比较 2 个浮点数,如果它们在极小值范围内,则返回 True。
EqualStrings
EqualStrings(a,b)
:将字符串 (a) 和字符串 (b) 相比较以确定它们是否完全匹配。如果字符串 a 和 b 中的所有字符都相同,则该函数将返回 True;如果有一个或多个字符不相同,则将返回 False。
IsEmpty
IsEmpty(v)
:测试 v 是否为 NULL 或等于""。
IsInteger
IsInteger(v)
:测试 (v) 是否包含可以转换为整数的值。如果是,则返回 True。
IsLowerCase
IsLowerCase(String)
:如果字符串中的所有(一个或多个)字母字符均为小写,则返回 True;如果一个或多个字母字符为大写,则返回 False。该函数将忽略非字母字符。请注意,此函数仅适用于区分大小写的字符,可能不适用于所有语言中的字符。
IsNull
IsNull(v)
:测试 (v) 是否为 NULL。如果 v 为 NULL,则返回 True,否则返回 False。
IsNumber
IsNumber(v)
:测试 (v) 的字段类型是否为数字。
IsSpatialObj
IsSpatialObj(v)
:测试 (v) 的字段类型是否为空间对象。
IsString
IsString(v)
:测试 (v) 的字段类型是否为字符串。
IsUpperCase
IsUpperCase(String)
:如果字符串中的所有(一个或多个)字母字符均为大写,则返回 True;如果一个或多个字母字符为小写,则返回 False。该函数将忽略非字母字符。请注意,此函数仅适用于区分大小写的字符,可能不适用于所有语言中的字符。