第155章 SQL函数 UPPER

将字符串表达式中的所有小写字母转换为大写字母的大小写转换函数。

大纲

UPPER(expression)

UPPER expression

参数

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

描述

UPPER 函数将所有字母字符转换为大写字母。这是 LOWER 函数的反函数。 UPPER 保留不变的数字、标点符号和前导或尾随空格。

UPPER 不强制将数字解释为字符串。 SQL 从数字中删除前导零和尾随零。指定为字符串的数字保留前导零和尾随零。

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

$SYSTEM.SQL.Functions.UPPER(expression)

UPPER 是字母大小写转换的标准函数，而不是排序规则。对于大写排序规则，使用 %SQLUPPER，它提供了数字、NULL 值和空字符串的高级排序规则。

示例

以下示例返回所有名称，选择那些名称的大写形式以“JO”开头的名称：

SELECT Name
FROM Sample.Person
WHERE UPPER(Name) %STARTSWITH UPPER('JO')

以下示例以大写形式返回所有名称，选择名称以“JO”开头的名称：

第154章 SQL函数 UNIX_TIMESTAMP

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

将日期表达式转换为 UNIX 时间戳的日期/时间函数。

大纲

UNIX_TIMESTAMP([date-expression])

参数

• date-expression - 可选 — 作为列名称、另一个标量函数的结果或日期或时间戳文字的表达式。 UNIX_TIMESTAMP 不会从一个时区转换到另一个时区。如果省略 date-expression，则默认为当前 UTC 时间戳。

描述

UNIX_TIMESTAMP 返回一个 UNIX® 时间戳，即自 '1970-01-01 00:00:00'以来的秒数（和小数秒）。

如果不指定 date-expression，则 date-expression 默认为当前 UTC 时间戳。因此，假设系统范围的默认精度为 3，UNIX_TIMESTAMP() 等效于 UNIX_TIMESTAMP(GETUTCDATE(3))。

如果指定 date-expression，UNIX_TIMESTAMP 会将指定的 date-expression 值转换为 UNIX 时间戳，计算该时间戳的秒数。 UNIX_TIMESTAMP 可以返回正数或负数秒数。

第153章 SQL函数 UCASE

将字符串中的所有小写字母转换为大写字母的大小写转换函数。

大纲

UCASE(string-expression)

{fn UCASE(string-expression)}

参数

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

描述

UCASE 将小写字母转换为大写以进行显示。它对非字母字符没有影响；它保留不变的数字、标点符号和前导或尾随空格。

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

UCASE 不强制将数字解释为字符串。 SQL 从数字中删除前导零和尾随零。指定为字符串的数字保留前导零和尾随零。

UCASE 不影响排序规则。 %SQLUPPER 函数是 SQL 中为不区分大小写的排序规则转换数据值的首选方法。

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

$SYSTEM.SQL.UPPER(expression)

示例

以下示例以大写字母返回每个人的姓名：

SELECT Name,{fn UCASE(Name)} AS CapName
     FROM Sample.Person

第152章 SQL函数 $TSQL_NEWID

大纲

$TSQL_NEWID()

描述

$TSQL_NEWID 返回一个全局唯一 ID (GUID)。 GUID 用于在偶尔连接的系统上同步数据库。 GUID 是一个 36 个字符的字符串，由 32 个十六进制数字组成，由连字符分成五组。它的数据类型是 %Library.UniqueIdentifier。

在 SQL 中提供了 $TSQL_NEWID 以支持Transact-SQL (TSQL)。对应的 TSQL 函数是 NEWID。

$TSQL_NEWID 函数不接受任何参数。请注意，参数括号是必需的。

%Library.GUID 抽象类提供对全局唯一 ID 的支持，包括 AssignGUID() 方法，该方法可用于为类分配全局唯一 ID。要生成 GUID 值，请使用 %SYSTEM.Util.CreateGUID() 方法。

示例

以下示例返回一个 GUID：

SELECT $TSQL_NEWID()

E8B3E0AB-5F5B-4E7F-B59F-166F5A56E055

在使用xDBC连接到字符集为US7ASCII的Oracle数据库时，大家可能遇到过中文的乱码问题，尤其是使用Oracle自己的xDBC驱动的时候。

字符集为US7ASCII的Oracle数据库虽然可以保存中文数据，但给客户端带来了很多麻烦，需要对获取和提交的数据进行转码。

在Ensemble/Health Connect/InterSystems IRIS 中使用SQL适配器连接到这样的Oracle数据库时，可以使用$ZCVT函数进行转码。

1. $ZCVT函数

$ZCVT函数是广泛使用的字符串转换函数，可以做大小写转换、编码转换、URL 和 URI 转换等。我们用其编码转换能力来解决字符集转码问题。

2. 获取的SQL结果集数据有中文时

这时，Oracle的驱动返回的中文数据通常是GB码，而不是Unicode或UTF码。可以通过$ZCVT函数对GB码的数据进行转码，转换为Unicode：

Set tCorrectData = $ZCVT(tOriginalData,"I","GB18030")

其中$ZCVT函数的第一个参数tOriginalData是获取到到结果集字段值；第二个参数“I”说明tOriginalData是输入字符串；第三个参数“GB18030”是说明输入字符串的字符集编码是GB18030。

[toc]

第151章 SQL函数 %TRUNCATE

将字符串截断为指定长度并应用 EXACT 排序规则的排序规则函数。

大纲

%TRUNCATE(expression[,length])

参数

• expression - 字符串表达式，可以是列名、字符串文字或另一个函数的结果，其中基础数据类型可以表示为任何字符类型（例如 CHAR 或 VARCHAR2）。表达式可以是子查询。
• length - 可选 — 截断长度，指定为整数。返回表达式的初始长度字符。如果省略长度，则 %TRUNCATE 排序规则与 %EXACT 排序规则相同。可以用双括号将长度括起来以抑制文字替换：((length))。

描述

%TRUNCATE 将表达式截断为指定的长度，然后在 EXACT 排序规则序列中返回它。

EXACT 排序规则首先按数字顺序排列纯数值（x=+x 的值），然后是字符串排序规则序列中的所有其他字符。 EXACT 字符串整理顺序与 ANSI 标准 ASCII 整理顺序相同：在大写字母字符之前整理数字，在小写字母字符之前整理大写字母字符。标点符号出现在序列中的多个位置。

%TRUNCATE 通过 NULL 不变。

%TRUNCATE 是一个 SQL 扩展，用于 SQL 查找查询。

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

第150章 SQL函数 TRUNCATE

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

大纲

{fn TRUNCATE(numeric-expr,scale)}

参数

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

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

描述

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

第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 关键字。

描述

第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。

第146章 SQL函数 TO_POSIXTIME

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

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

大纲

TO_POSIXTIME(date_string[,format])

参数

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

描述

第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 的数字。

我们很高兴地宣布，从7.2.4版本开始，DBeaver已经支持开箱即用InterSystems IRIS的。 你不需要再手动配置它，只要在连接列表中找到IRIS的图标即可。

第144章 SQL函数 TO_DATE（二）

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

可以使用 DDD 将一年中的某一天（自 1 月 1 日以来经过的天数）转换为实际日期。格式字符串 DDDYYYY 必须与由整数天数和四位数年份组成的相应 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 
	}
}

第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.TODATE(date_string,format)

第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

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

以下嵌入式 SQL 示例显示了分隔符的使用：

第141章 SQL函数 TO_CHAR（二）

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

• $HOROLOG 时间整数（$HOROLOG 的时间部分）。 tochar-expression 的值必须是有效的逻辑时间（0 到 86399 范围内的整数）。不要提供包含日期和时间组件的完整 $HOROLOG 值（例如 64701,42152）； TO_CHAR 时间转换会错误地将 $HOROLOG 的第一个（日期）组件转换为格式化的时间字符串，并忽略第二个（时间）组件。
• 逻辑时间戳值。 tochar-expression 的值必须是 %TimeStamp 数据类型（不是字符串数据类型），格式为 YYYY-MM-DDhh: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.TOCHAR(tochar-expression,format)

有效和无效的参数

第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 的浮点数通过截断小数部分转换为整数。

第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。

第133章 SQL函数 STRING

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

大纲

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

参数

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

描述

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

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

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

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

示例

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

第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 将数字转换为字符串：

第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 
		}
	}
}

第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 的平方根：

第129章 SQL函数 %SQLUPPER

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

大纲

%SQLUPPER(expression[,maxlen]) 

%SQLUPPER expression

参数

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

描述

SQLUPPER 是默认排序规则。

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

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

第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 示例返回名称字段长度的空格字符串：