第150章 SQL函数 TRUNCATE

标量数值函数，按指定位数截断一个数。

大纲

{fn TRUNCATE(numeric-expr,scale)}

参数

• numeric-expr - 要截断的数字。数字或数字表达式。
• scale - 计算结果为一个整数的表达式，该整数指定要截断的位数，从小数点开始计算。可以是零、正整数或负整数。如果比例是小数，会将其舍入为最接近的整数。

Truncate返回NUMERIC或DOUBLE数据类型。如果NUMERIC-EXPR的数据类型为DOUBLE，则TRUNCATE返回DOUBLE；否则返回NUMERIC。

描述

TRUNCATE通过从小数点开始按小数位数截断NUMERIC-EXPR。它不对数字进行四舍五入，也不添加填充零。在截断操作之前，将删除前导零和尾随零。

• 如果小数位数为正数，则在小数点右侧的位数处执行截断。如果小数位数等于或大于小数位数，则不会发生截断或零填充。
• 如果Scale为零，则该数字将被截断为整数。换句话说，在小数点右侧的零位数处执行截断；所有小数位和小数点本身都被截断。
• 如果小数位数为负数，则在小数点左侧的位数处执行截断。如果小数位数等于或大于数字中的整数位数，则返回零。
• 如果NUMERIC-EXPR为零(但表示为00.00、-0等)。TRUNCATE返回0(零)，不带小数位数，无论小数位数是多少。

第149章 SQL函数 TRIM

字符串函数，它返回删除了指定的前导和/或尾随字符的字符串。

大纲

TRIM([end_keyword] [characters FROM] string-expression)

参数

• end_keyword - 可选 — 一个关键字，指定要剥离的字符串表达式的哪一端。可用值为 LEADING、TRAILING 或 BOTH。默认为两者。
• characters - 可选 — 一个字符串表达式，指定要从字符串表达式中删除的字符。指定字符的每个实例都从指定的末端被剥离，直到遇到此处未指定的字符。因此TRIM(BOTH 'ab' FROM 'bbbaacaaa') 返回 ‘c’。在此示例中，BOTH 关键字是可选的。如果未指定字符，TRIM 会去除空格。如果指定了字符，则需要 FROM 关键字。如果指定了 end_keyword 而未指定字符，则允许使用 FROM 关键字（但不是必需的）。如果没有指定这些参数，则不允许使用 FROM 关键字。
• string-expression - 要剥离的字符串表达式。字符串表达式可以是列名、字符串文字或另一个函数的结果，其中基础数据类型可以表示为任何字符类型（例如 CHAR 或 VARCHAR2）。如果省略了字符和 end_keyword，则省略 FROM 关键字。

描述

TRIM 从提供的值的开头和/或结尾去除指定的字符。

第147章 SQL函数 TO_TIMESTAMP

将格式化字符串转换为时间戳的日期函数。

大纲

TO_TIMESTAMP(date_string[,format])

参数

• date_string - 要转换为时间戳的字符串表达式。此表达式可能包含日期值、时间值或日期和时间值。
• format - 可选 — 对应于 date_string 的日期和时间格式字符串。如果省略，则默认为 DD MON YYYY HH:MI:SS。

描述

TO_TIMESTAMP 函数将各种格式的日期和时间字符串转换为标准时间戳，数据类型为 TIMESTAMP。 TO_TIMESTAMP 返回具有以下格式的时间戳：

yyyy-mm-dd hh:mm:ss

始终包括前导零。时间使用 24 小时制指定。默认情况下，返回的时间戳不包括小数秒。

注意：TO_TIMESTAMP 以 ODBC 格式返回标准时间戳。 TO_POSIXTIME 返回一个编码的 64 位时间戳。 TO_POSIXTIME 是新编程的推荐时间戳格式。

必须指定匹配的 date_string 和格式。如果省略格式，则 date_string 必须匹配 DD MON YYYY HH:MI:SS。

如果 date_string 省略了时间戳的组成部分，则 TO_TIMESTAMP 提供缺少的组成部分。

第146章 SQL函数 TO_POSIXTIME

注：此函数在IRIS版本可用，Cache不可用。

将格式化的日期字符串转换为 %PosixTime 时间戳的日期/时间函数。

大纲

TO_POSIXTIME(date_string[,format])

参数

• date_string - 要转换为 %PosixTime 时间戳的字符串表达式。此表达式可能包含日期值、时间值或日期和时间值。
• format - 可选 — 对应于 date_string 的日期和时间格式字符串。如果省略，则默认为 DD MON YYYY HH:MI:SS。

描述

TO_POSIXTIME 函数将各种格式的日期和时间字符串转换为 %PosixTime 时间戳，数据类型为 %Library.PosixTime。 TO_POSIXTIME 返回 %PosixTime 时间戳作为计算值，该值基于从 1970-01-01 00:00:00 的任意起点经过的秒数，编码为 64 位有符号整数。从该日期开始经过的实际秒数（和小数秒）是 Unix®timestamp，一个数值。 对 Unix® 时间戳进行编码以生成 %PosixTime 时间戳。由于 %PosixTime 时间戳值已编码，因此 1970-01-01 00:00:00 表示为 1152921504606846976。

第145章 SQL函数 TO_NUMBER

将字符串表达式转换为 NUMERIC 数据类型的值的字符串函数。

大纲

TO_NUMBER(string-expression)

TONUMBER(string-expression)

参数

• string-expression - 要转换的字符串表达式。表达式可以是列名、字符串文字或另一个函数的结果，其中基础数据类型为 CHAR 或 VARCHAR2 类型。

描述

名称 TO_NUMBER 和 TONUMBER 可以互换。它们支持 Oracle 兼容性。

TO_NUMBER 将字符串表达式转换为数字数据类型 NUMERIC。但是，如果 string-expression 的数据类型为 DOUBLE，则 TO_NUMBER 返回一个数据类型为 DOUBLE 的数字。

TO_NUMBER 转换采用数字字符串并通过解析加号和减号、扩展指数符号（“E”或“e”）以及删除前导零将其转换为规范数字。 TO_NUMBER 在遇到非数字字符（例如字母或数字组分隔符）时停止转换。因此字符串 '7dwarves' 转换为 7。如果 string-expression 的第一个字符是非数字字符串，则 TO_NUMBER 返回 0。如果 string-expression 是空字符串 ('')，则 TO_NUMBER 返回 0。TO_NUMBER 将 -0 解析为 0 .

第144章 SQL函数 TO_DATE（二）

一年中的某一天（DDD 格式）

可以使用 DDD 将一年中的某一天（自 1 月 1 日以来经过的天数）转换为实际日期。格式字符串 DDD YYYY 必须与由整数天数和四位数年份组成的相应 date_string 配对。 （与 DDD 一起使用时，两位数的年份必须指定为 RR（而不是 YY）。）格式字符串 DDD 默认为当前年份。经过的天数必须是 1 到 365 范围内的正整数（如果 YYYY 是闰年，则为 366）。四位数年份必须在标准 日期范围内：1841 到 9999。DDD 和 YYYY 格式元素可以按任意顺序指定；它们之间的分隔符是强制性的。以下示例显示了这一年中的一天的用法：

/// d ##class(PHA.TEST.SQLFunction).ToDate4()
ClassMethod ToDate4()
{
	NEW SQLCODE
	&sql(
		SELECT TO_DATE('2018:60','YYYY:DDD')
		INTO :a
	)
	if SQLCODE = 0 {
		w a," = ",$ZDATE(a,1,,4) 	
	} else { 
		w "error:",SQLCODE 
	}
}

DHC-APP>d ##class(PHA.TEST.SQLFunction).

第143章 SQL函数 TO_DATE（一）

将格式化字符串转换为日期的日期函数。

大纲

TO_DATE(date_string[,format])

TODATE(date_string[,format])

参数

• date_string - 要转换为日期的字符串。基础数据类型为 CHAR 或 VARCHAR2 的字符串日期表达式。
• format - 可选 — 对应于 date_string 的日期格式字符串。如果省略格式，DD MON YYYY& 是默认值；此默认值是可配置的。

描述

名称 TO_DATE 和 TODATE 是可互换的，并且支持 Oracle 兼容性。

TO_DATE 函数将各种格式的日期字符串转换为日期整数值，数据类型为 DATE。它用于输入各种字符串格式的日期，并将它们存储在标准的内部表示中。 TO_DATE 返回具有以下格式的日期：

nnnnn

其中 nnnnn 是介于 0（1840 年 12 月 31 日）和 2980013（9999 年 12 月 31 日）之间的正整数，包括端点。这表示天数。时间值被忽略。 1840 年 12 月 31 日之前的日期可以使用儒略日期来表示，如下所述。

也可以使用 TODATE() 方法调用从 ObjectScript 调用此函数：

$SYSTEM.SQL.Functions.

第142章 SQL函数 TO_CHAR（三）

数字到字符串示例

以下嵌入式 SQL 示例显示了基本的数字到字符串的转换：

/// d ##class(PHA.TEST.SQLFunction).ToChar3()
ClassMethod ToChar3()
{
	&sql(
		SELECT 
			TO_CHAR(1000,'9999'),
			TO_CHAR(10,'9999')
		INTO 
			:numfull,:numshort
	)
	if SQLCODE '= 0 {
		w !,"Error code ",SQLCODE 
	} else {
		w !,"Formatted number:",numfull
		w !,"Formatted number:",numshort
		w !,"Note leading blanks" 
	}
}

DHC-APP>d ##class(PHA.TEST.SQLFunction).ToChar3()
 
Formatted number: 1000
Formatted number:   10
Note leading blank

返回具有适当数量的前导空格的指定数字。无符号正数前面总是有一个空白字符。如果指定数字的位数少于格式参数，则提供额外的前导空格。

第141章 SQL函数 TO_CHAR（二）

可以使用 TO_CHAR 将以下 tochar 表达式时间值转换为格式化的时间字符串：

• $HOROLOG 时间整数（$HOROLOG 的时间部分）。 tochar-expression 的值必须是有效的逻辑时间（0 到 86399 范围内的整数）。不要提供包含日期和时间组件的完整 $HOROLOG 值（例如 64701,42152）； TO_CHAR 时间转换会错误地将 $HOROLOG 的第一个（日期）组件转换为格式化的时间字符串，并忽略第二个（时间）组件。
• 逻辑时间戳值。 tochar-expression 的值必须是 %TimeStamp 数据类型（不是字符串数据类型），格式为 YYYY-MM-DD hh:mm:ss。时间戳的日期部分被忽略，时间部分被转换。例如，SYSDATE 是一个逻辑时间戳。
• 标准 ODBC 时间格式的时间值。 tochar-expression 的值必须采用 hh:mm:ss 格式，并且可以是字符串。
• 本地时间格式的时间值（使用当前 NLS 区域设置）。例如，如果 NLS TimeSeparator 设置为“^”，则 tochar-expression 的值可以采用 hh^mm^ss 格式，并且可以是字符串。

第140章 SQL函数 TO_CHAR（一）

将日期、时间戳或数字转换为格式化字符串的字符串函数。

大纲

TO_CHAR(tochar-expression[,format])

TOCHAR(tochar-expression[,format])

参数

• tochar-expression - 要转换的逻辑日期、时间戳或数字表达式。
• format - 可选 — 为 tochar 表达式转换指定日期、时间戳或数字格式的字符代码。如果省略，TO_CHAR 将 tochar-expression 作为规范数字返回。

描述

名称 TO_CHAR 和 TOCHAR 是可互换的，并且支持 Oracle 兼容性。

带格式的 TO_CHAR 函数有五种用途：

• 将日期整数转换为格式化的日期字符串。

• 日期在1840年之前转换为朱利安日期int

• 时间的整数转换为格式化时间生态

• 将日期和时间格式化的datetime

• 将数字转换成一个格式化的数字字符串。

这个函数也可以从ObjectScrip调用

$SYSTEM.SQL.Functions.

第139章 SQL函数 TIMESTAMPDIFF

一个标量日期/时间函数，它返回指定日期部分的两个时间戳之间差异的整数计数。

大纲

{fn TIMESTAMPDIFF(interval-type,startdate,enddate)}

参数

• interval-type - 返回值将表示的时间/日期间隔类型。
• startdate - 时间戳值表达式。
• enddate - 将与 startdate 进行比较的时间戳值表达式。

描述

TIMESTAMPDIFF 函数返回指定日期部分间隔（秒、天、周等）的两个给定时间戳之间的差异（即，从另一个中减去一个时间戳）。返回的值是一个 INTEGER，即两个时间戳之间的这些间隔数。 （如果 enddate 早于 startdate，则 TIMESTAMPDIFF 返回负 INTEGER 值。）

开始日期和结束日期是时间戳。这些时间戳可以是 %Library.TimeStamp 数据类型格式 (yyyy-mm-dd hh:mm:ss.ffff) 或 %Library.PosixTime 数据类型格式（编码的 64 位有符号整数）。

第138章 SQL函数 TIMESTAMPADD

一个标量日期/时间函数，它返回一个新的时间戳，该时间戳是通过将指定日期部分的多个间隔添加到时间戳来计算的。

大纲

{fn TIMESTAMPADD(interval-type,integer-exp,timestamp-exp)}

参数

• interval-type - integer-exp 表示的时间/日期间隔类型，指定为关键字。
• integer-exp - 要添加到 timestamp-exp 的整数值表达式。
• timestamp-exp - 时间戳值表达式，将增加 integer-exp 的值。

描述

TIMESTAMPADD 函数通过将指定的日期部分增加指定的单位数来修改日期/时间表达式。例如，如果 interval-type 是 SQL_TSI_MONTH 并且 integer-exp 是 5，则 TIMESTAMPADD 将 timestamp-exp 增加五个月。还可以通过为 integer-exp 指定负整数来减少日期部分。

TIMESTAMPADD 返回与输入timestamp-exp 数据类型相同的时间戳。此时间戳可以是 %Library.TimeStamp 数据类型格式 (yyyy-mm-dd hh:mm:ss.ffff) 或 %Library.PosixTime 数据类型格式（编码的 64 位有符号整数）。

第137章 SQL函数 TAN

标量数值函数，返回角度的正切（以弧度为单位）。

大纲

{fn TAN(numeric-expression)}

参数

• numeric-expression - 一个数值表达式。这是一个以弧度表示的角度。

TAN 返回 NUMERIC 或 DOUBLE 数据类型。如果 numeric-expression 是数据类型 DOUBLE，则 TAN 返回 DOUBLE；否则，它返回 NUMERIC。

描述

TAN 接受任何数值并返回其切线。如果传递 NULL 值，TAN 返回 NULL。 TAN 将非数字字符串视为数值 0。

TAN 返回一个精度为 36、比例为 18 的值。

TAN 只能用作 ODBC 标量函数（使用大括号语法）。

可以使用 DEGREES 函数将弧度转换为度数。可以使用 RADIANS 函数将度数转换为弧度。

示例

以下示例显示了 TAN 的效果。

SELECT {fn TAN(0.52)} AS Tangent 


0.572561830251668415

第136章 SQL函数 SUBSTRING

字符串函数，它从任何数据类型的数据（包括流数据）中返回一个子字符串。

大纲

SUBSTRING(string-expression,start[,length])

SUBSTRING(string-expression FROM start [FOR length])

{fn SUBSTRING(string-expression,start[,length])}

参数

• string-expression - 要从中派生子字符串的字符串表达式。表达式，可以是列名、字符串文字或另一个标量函数的结果。字段可以是任何数据类型：字符串（例如 CHAR 或 VARCHAR）、数字或数据类型为 %Stream.GlobalCharacter 或 %Stream.GlobalBinary 的数据流字段。
• start - 一个整数，它指定 string-expression 中开始子字符串的位置。 string-expression 中的第一个字符位于位置 1。如果起始位置高于字符串的长度，则 SUBSTRING 返回一个空字符串 。如果起始位置小于 1（零或负数），则子字符串从位置 1 开始，但子字符串的长度会减少起始位置。
• length - 可选 — 一个整数，指定要返回的子字符串的长度。如果未指定长度，则默认返回字符串的其余部分。

第135章 SQL函数 SUBSTR

返回从指定字符串表达式派生的子字符串的字符串函数。

大纲

SUBSTR(string-expression,start[,length])

参数

• string-expression - 要从中派生子字符串的字符串表达式。表达式可以是列名、字符串文字或另一个标量函数的结果，其中基础数据类型可以表示为任何字符类型（例如 CHAR 或 VARCHAR）。
• start - 一个整数，它指定子字符串在字符串表达式中的开始位置。正的起始位置指定从字符串开头开始的字符数。 string-expression1 中的第一个字符位于位置 1。负起始位置指定从字符串末尾算起的字符数。如果 start 为 0（零），则将其视为 1。
• length - 可选 — 一个正整数，指定要返回的子字符串的长度。此值指定子字符串在起始位置右侧结束长度字符。如果省略，则子字符串从字符串表达式的开头到结尾。如果长度为 0 或负数， 返回 NULL。

描述

因为 start 可以是负数，所以可以从原始字符串的开头或结尾获取子字符串。

作为参数传递给 SUBSTR 的浮点数通过截断小数部分转换为整数。

• 如果 start 为 0、–0 或 1，则返回的子字符串从字符串的第一个字符开始。
• 如果 start 是负数，则返回的子字符串从字符串末尾开始该数量的字符，-1 表示字符串的最后一个字符。

第134章 SQL函数 STUFF

字符串函数，用于替换字符串中的子字符串。

大纲

STUFF(string,start,length,substring)

参数

• string - 作为子字符串替换目标的字符串表达式。
• start - 替换的起点，指定为正整数。从字符串开头开始的字符数，从 1 开始计数。允许的值为 0 到字符串的长度。要追加字符，请指定 0 的开头和 0 的长度。空字符串或非数字值被视为 0。
• length - 要替换的字符数，指定为正整数。要插入字符，请将长度指定为 0。要在开始后替换所有字符，请指定大于现有字符数的长度。空字符串或非数字值被视为 0。
• substring - 一个字符串表达式，用于替换由其起始点和长度标识的子字符串。可以比它替换的子字符串更长或更短。可以是空字符串。

描述

STUFF 用另一个子字符串替换一个子字符串。它标识要替换为位置和长度的子字符串，并将其替换为子字符串。

此函数提供与 Transact-SQL 实现的兼容性。

替换子字符串可能比原始值长或短。要删除原始值，子字符串可以是空字符串 ('')。

起始值必须在字符串的当前长度范围内。您可以通过指定起始值 0 将子字符串附加到字符串的开头。空字符串或非数字值被视为 0。

为 start、length 或 substring 参数指定 NULL 将返回 NULL。

STUFF 不能将 %Stream.

第133章 SQL函数 STRING

将表达式转换并连接成字符串的函数。

大纲

STRING(string1[,string2][,...][,stringN])

参数

• string - 表达式，可以是字段名称、字符串文字、数字或另一个函数的结果，其中基础数据类型可以表示为任何字符类型（例如 CHAR 或 VARCHAR）。如果指定了字段名称，则使用逻辑值。

描述

STRING 将一个或多个字符串转换为 STRING 格式，然后将这些字符串连接成一个字符串。不执行大小写转换。

STRING 在字符串转换之前将数字转换为其规范形式。因此，它执行算术运算，从数字中删除前导和尾随零以及前导加号。

如果字符串参数之一为 NULL，则 STRING 返回 NULL。如果字符串参数之一是空字符串 ('')，则 STRING 将连接其他参数。 STRING 保留空格。

可以使用 %SQLSTRING 函数转换数据值以进行区分大小写的字符串比较，或使用 %SQLUPPER 函数转换数据值以进行不区分大小写的字符串比较。

示例

在以下嵌入式 SQL 示例中，STRING 将三个子字符串连接成一个字符串。该示例显示了空格、空字符串和 NULL 的处理：

/// d ##class(PHA.TEST.

第132章 SQL函数 STR

将数字转换为字符串的函数。

大纲

STR(number[,length[,decimals]])

参数

• number - 解析为数字的表达式。它可以是字段名称、数字或其他函数的结果。如果指定了字段名称，则使用逻辑值。
• length - 可选 — 一个整数，指定所需输出字符串的总长度，包括所有字符（数字、小数点、符号、空格）。默认值为 10。
• decimals - 可选 — 一个整数，指定要包含的小数点右侧的位数。默认值为 0。

描述

STR 将数字转换为 STRING 格式，根据长度和小数的值截断数字。长度参数必须足够大以包含数字的整个整数部分，并且，如果指定小数，则该小数位数加 1（用于小数点）。如果长度不够大，则 STR 将返回一个星号 (*) 字符串，该字符串等于长度。

STR 在字符串转换之前将数字转换为其规范形式。因此，它执行算术运算，从数字中删除前导和尾随零以及前导加号。

如果 number 参数为 NULL，则 STR 返回 NULL。如果 number 参数是空字符串 ('')，则 STR 返回空字符串。 STRING 保留空格。

示例

在以下嵌入式 SQL 示例中，STR 将数字转换为字符串：

/// d ##class(PHA.TEST.SQLFunction).

第131章 SQL函数 SQUARE

返回数字平方的标量数值函数。

大纲

SQUARE(numeric-expression)

参数

• numeric-expression - 解析为数值的表达式。

SQUARE 返回 NUMERIC 或 DOUBLE 数据类型。如果 numeric-expression 是数据类型 DOUBLE，则 SQUARE 返回 DOUBLE；否则，它返回 NUMERIC。

描述

SQUARE 返回数值表达式的平方。如果传递 NULL 值，SQUARE 返回 NULL。

SQUARE 返回的精度和小数位数与 SQL 乘法运算符返回的相同。

示例

以下嵌入式 SQL 示例返回整数 0 到 10 的平方：

/// d ##class(PHA.TEST.SQLFunction).Square()
ClassMethod Square()
{
	s a = 0
	while a < 11 {
		&sql(
			SELECT SQUARE(:a) INTO :b
		)
		if SQLCODE '= 0 {
			w !,"Error code ",SQLCODE 
		} else {
			w !,"The square of ",a," = ",b
			s a = a + 1 
		}
	}
}

DHC-APP>d ##class(PHA.TEST.

第130章 SQL函数 SQRT

返回给定数值表达式的平方根的数值函数。

大纲

SQRT(numeric-expression)

{fn SQRT(numeric-expression)}

参数

• numeric-expression - 解析为计算平方根的正数的表达式。

SQRT 返回 NUMERIC 或 DOUBLE 数据类型。如果 numeric-expression 是数据类型 DOUBLE，则 SQRT 返回 DOUBLE；否则，它返回 NUMERIC。

描述

SQRT 返回 numeric-expression 的平方根。 numeric-expression 必须是正数。负数值表达式（-0 除外）会生成 SQLCODE -400 错误。如果传递 NULL 值，SQRT 返回 NULL。

SQRT 返回一个精度为 36、小数位数为 18 的值。

SQRT 可以指定为常规标量函数或 ODBC 标量函数（使用大括号语法）。

示例

以下示例显示了两种 SQRT 语法形式。两者都返回 49 的平方根：

SELECT SQRT(49) AS SRoot,{fn SQRT(49)} AS ODBCSRoot

7	7

以下嵌入式 SQL 示例返回整数 0 到 10 的平方根：

/// d ##class(PHA.TEST.SQLFunction).

第129章 SQL函数 %SQLUPPER

将值排序为大写字符串的排序规则函数。

大纲

%SQLUPPER(expression[,maxlen]) 

%SQLUPPER expression

参数

• expression - 字符串表达式，可以是列名、字符串文字或另一个函数的结果，其中基础数据类型可以表示为任何字符类型（例如 CHAR 或 VARCHAR）。表达式可以是子查询。
• maxlen - 可选 — 一个整数，指定整理后的值将被截断为 maxlen 的值。请注意， maxlen 包括附加的前导空格。您可以用双括号将 maxlen 括起来以抑制文字替换：((maxlen))。

描述

SQLUPPER 是默认排序规则。

%SQLUPPER 将表达式转换为排序为（不区分大小写）大写字符串的格式。 %SQLUPPER 将所有字母字符转换为大写，从字符串中去除尾随空格（空格、制表符等），然后在字符串开头添加一个前导空格。这个附加的空格会导致 NULL 和数值被整理为字符串。

SQL 在将数字传递给函数之前将数值转换为规范形式（删除前导零和尾随零、扩展指数等）。 SQL 不会将数字字符串转换为规范形式。

因为 %SQLUPPER 将空格附加到所有值，所以它将 NULL 值作为空格进行整理，字符串长度为 1

第128章 SQL函数 %SQLSTRING

将值排序为字符串的排序规则函数。

大纲

%SQLSTRING(expression[,maxlen])

%SQLSTRING expression

参数

• expression - 字符串表达式，可以是列名、字符串文字或另一个函数的结果，其中基础数据类型可以表示为任何字符类型（例如 CHAR 或 VARCHAR）。表达式可以是子查询。
• maxlen - 可选 — 一个正整数，指定整理后的值将被截断为 maxlen 的值。请注意， maxlen 包括附加的前导空格。可以用双括号将 maxlen 括起来以抑制文字替换：((maxlen))。

描述

%SQLSTRING 将表达式转换为按（区分大小写）字符串排序的格式。 %SQLSTRING 从字符串中去除尾随空格（空格、制表符等），然后在字符串的开头添加一个前导空格。这个附加的空格强制将 NULL 和数值作为字符串进行整理。从数字中删除前导零和尾随零。

因为 %SQLSTRING 将空格附加到所有值，所以它将 NULL 值整理为空格，字符串长度为 1。 %SQLSTRING 将任何仅包含空格（空格、制表符等）的值整理为 SQL 空字符串('')。当 %SQLSTRING 将空格附加到空（零长度）字符串时，它会将空格加上空字符串的内部表示形式 $CHAR(0) 进行整理，从而导致字符串长度为 2。

第127章 SQL函数 SPACE

返回一串空格的字符串函数。

大纲

SPACE(count)

{fn SPACE(count)}

参数

• count - 整数表达式，指定要返回的空格数。

描述

SPACE 返回一个空格字符串 count 个空格长。如果 count 是数字字符串、十进制数或混合数字字符串， 会将其解析为其整数部分。如果 count 是负数或非数字字符串将其解析为 0。

要从字符串中删除空格，请使用 LTRIM（前导空格）或 RTRIM（尾随空格）。

注意：不应将 SPACE 函数与 SPACE 归类类型混淆。 SPACE 排序规则在一个值前面添加一个空格，强制将其作为字符串进行评估。为了建立 SPACE 归类，CREATE TABLE 提供了一个 %SPACE 归类关键字，ObjectScript 提供了 %SYSTEM.Util 类的 Collation() 方法。

示例

以下嵌入式 SQL 示例返回名称字段长度的空格字符串：

/// d ##class(PHA.TEST.SQLFunction).Space()
ClassMethod Space()
{
	&sql(
		SELECT SPACE(LENGTH(name))
			INTO :a
		FROM Sample.Person
	)
	if SQLCODE '= 0 {
		w !

第126章 SQL函数 SIN

标量数值函数，返回角度的正弦值（以弧度为单位）。

大纲

{fn SIN(numeric-expression)}

参数

• numeric-expression - 数值表达式。这是一个以弧度表示的角度。

SIN 返回 NUMERIC 或 DOUBLE 数据类型。如果 numeric-expression 是数据类型 DOUBLE，则 SIN 返回 DOUBLE；否则，它返回 NUMERIC。

描述

SIN 接受任何数值并将其正弦作为浮点数返回。如果传递一个 NULL 值，SIN 返回 NULL。 SIN 将非数字字符串视为数值 0。

SIN 返回一个精度为 19、小数位数为 18 的值。

SIN 只能用作 ODBC 标量函数（使用大括号语法）。

可以使用 DEGREES 函数将弧度转换为度数。可以使用 RADIANS 函数将度数转换为弧度。

示例

以下示例显示了 SIN 的效果：

SELECT {fn SIN(0.52)} AS Sine

0.496880137843736714

第125章 SQL函数 SIGN

返回给定数值表达式符号的数值函数。

大纲

SIGN(numeric-expression)

{fn SIGN(numeric-expression)}

参数

• numeric-expression - 要为其返回符号的数字。

SIGN 返回 SMALLINT 数据类型。

描述

SIGN 返回以下内容：

• -1 如果 numeric-expression 小于零。
• 如果 numeric-expression 为零，则为 0（零）：0、+0 或 -0。
• 如果 numeric-expression 大于零，则为 1。
• 如果 numeric-expression 为 NULL，或者它是非数字字符串，则为 NULL。

SIGN 可用作 ODBC 标量函数（使用花括号语法）或 SQL 通用函数。

SIGN 在确定其值之前将数值表达式转换为规范形式。例如，SIGN(-+-+3) 和 SIGN(-3+5) 都返回 1，表示一个正数。

注意：两个负号（连字符）是内嵌注释指示符。因此，指定两个连续负号的 SIGN 参数必须显示为用引号括起来的数字字符串。

示例

以下示例显示了 SIGN 的效果：

SELECT SIGN(-49) AS PosNeg

-1

SELECT {fn SIGN(-0.0)} AS PosNeg

0

SELECT SIGN(-+-16.

第124章 SQL函数 SECOND

返回日期时间表达式的秒数的时间函数。

大纲

{fn SECOND(time-expression)}

参数

• time-expression - 作为列名、另一个标量函数的结果或字符串或数字文字的表达式。它必须解析为时间戳字符串或 $HOROLOG 字符串，其中基础数据类型可以表示为 %Time、%TimeStamp 或 %PosixTime。

描述

SECOND 返回一个从 0 到 59 的整数，也可能返回小数秒。秒数是针对 $HOROLOG 或 $ZTIMESTAMP 值、ODBC 格式日期字符串（没有时间值）或时间戳计算的。

时间表达式时间戳可以是数据类型 %Library.PosixTime（编码的 64 位有符号整数），也可以是数据类型 %Library.TimeStamp (yyyy-mm-dd hh:mm:ss.fff)。

要更改默认时间格式，请使用 SET OPTION 命令。

必须提供时间戳字符串 (yyyy-mm-dd hh:mm:ss) 或 $HOROLOG 字符串。 $HOROLOG 字符串可以是完整的日期时间字符串 (63274,37279) 或只是 $HOROLOG (37279) 的时间整数部分。不能提供时间字符串 (hh:mm:ss)；无论实际秒数如何，这始终返回 0。

日期时间字符串的时间部分必须是有效时间。

第123章 SQL函数 SEARCH_INDEX

从索引的 Find() 方法返回一组值的函数。

大纲

SEARCH_INDEX([[schema_name.]table-name.]index-name[,findparam[,...])

参数

• table-name - 可选 — 为其定义了 index-name 的现有表的名称。不能是一个视图。表的 schema_name 是可选的。如果省略，则搜索 FROM 子句中指定的所有表。
• index-name - 要搜索的索引。现有索引的索引映射的 SqlName。
• findparam - 可选 — 要传递给索引的 Find() 方法的参数或逗号分隔的参数列表。

描述

SEARCH_INDEX 调用 index-nameFind() 方法并返回一组值。可以选择将参数传递给此 Find() 方法。例如，SEARCH_INDEX(Sample.Person.NameIDX) 调用 Sample.Person.NameIDXFind() 方法。

SEARCH_INDEX 可以与 WHERE 子句中的 %FIND 谓词一起使用，以提供对象的 oref，该对象提供封装一组值的抽象表示。这些值通常是查询运行时调用的方法返回的行 ID。 SEARCH_INDEX 调用索引的 Find() 方法来返回这个

第122章 SQL函数 RTRIM

字符串函数，它返回一个删除了尾随空格的字符串。

大纲

RTRIM(string-expression)

{fn RTRIM(string-expression)}

参数

• string-expression - 字符串表达式，可以是列名、字符串文字或另一个标量函数的结果，其中基础数据类型可以表示为任何字符类型（例如 CHAR 或 VARCHAR）。

描述

RTRIM 从字符串表达式中去除尾随空格，并将字符串作为 VARCHAR 类型返回。如果 string-expression 为 NULL，则 RTRIM 返回 NULL。如果 string-expression 是一个完全由空格组成的字符串，则 RTRIM 返回空字符串 ('')。

无论要裁剪的输入表达式的数据类型是什么，RTRIM总是返回数据类型VARCHAR。

RTRIM 留下前导空白；要删除前导空格，请使用 LTRIM。要删除任何类型的前导和/或尾随字符，请使用 TRIM。要使用尾随空格或其他字符填充字符串，请使用 RPAD。要创建一串空白，请使用 SPACE。

请注意，RTRIM 可用作 ODBC 标量函数（使用大括号语法）或 SQL 通用函数。

示例

以下嵌入式 SQL 示例从字符串中删除了五个尾随空格。它留下五个前导空白：

/// d ##class(PHA.TEST.SQLFunction).

第121章 SQL函数 RPAD

字符串函数，它返回一个右填充到指定长度的字符串。

大纲

RPAD(string-expression,length[,padstring])

参数

• string-expression - 字符串表达式，可以是列名、字符串文字、主机变量或另一个标量函数的结果。可以是可转换为 VARCHAR 数据类型的任何数据类型。字符串表达式不能是流。
• length - 整数，指定返回的字符串中的字符数。
• padstring - 可选 — 由一个字符或一串字符组成的字符串，用于填充输入字符串表达式。 padstring 字符或字符附加到 string-expression 的右侧，以提供创建长度字符的输出字符串所需的尽可能多的字符。 padstring 可以是字符串文字、列、主机变量或另一个标量函数的结果。如果省略，则默认为空格字符。

描述

RPAD 用尾随填充字符填充字符串表达式。它返回填充到长度字符数的字符串的副本。如果字符串表达式的长度超过 length 个字符，则返回字符串被截断为 length 个字符。

如果 string-expression 为 NULL，则 RPAD 返回 NULL。如果 string-expression 为空字符串 ('') ，则 RPAD 返回一个完全由填充字符组成的字符串。返回的字符串是 VARCHAR 类型。

第120章 SQL函数 ROUND

以指定位数舍入或截断数字的数值函数。

大纲

ROUND(numeric-expr,scale[,flag])

{fn ROUND(numeric-expr,scale[,flag])}

参数

• numeric-expr - 要四舍五入的数字。一个数值表达式。
• scale - 计算结果为整数的表达式，该整数指定要舍入到的位数，从小数点开始计数。可以是零、正整数或负整数。如果 scale 是小数， 会将其四舍五入为最接近的整数。
• flag - 可选 — 一个布尔标志，指定是舍入还是截断 numeric-expr：0=round, 1=truncate。默认值为 0。

ROUND 返回与 numeric-expr 相同的数据类型。

描述

此函数可用于将数字舍入或截断为指定的小数位数。

ROUND 将 numeric-expr 舍入或截断以缩放位置，从小数点开始计数。舍入时，数字 5 始终向上舍入。在 ROUND 循环或截断操作后删除尾随零。不返回前导零。

• 如果 scale 为正数，则在小数点右侧的该位数处进行舍入。如果 scale 等于或大于小数位数，则不会发生舍入或零填充。
• 如果 scale 为零，则舍入到最接近的整数。换句话说，在小数点右边的零位处进行舍入；所有小数位和小数点本身都被删除。
• 如果 scale 为负数，则在小数点左侧的该位数处进行舍入。