第五十三章 SQL函数 %EXACT

排序规则函数，可将字符转换为精确的排序规则格式。

大纲

%EXACT(expression)

%EXACT expression

参数

• expression - 字符串表达式，可以是列名、字符串文字、数字或另一个函数的结果，其中底层数据类型可以表示为任何字符类型(如CHAR或VARCHAR2)。

描述

%Exact返回精确排序规则序列中的表达式。此归类序列按如下方式对值进行排序：

1. NULL排序在所有实际值之前。%Exact对空值没有影响。这与默认排序规则相同。
2. 规范数值(无论输入为数字还是字符串)在字符串值之前按数字顺序排序。
3. 字符串值按区分大小写的字符串顺序排序。字符串的精确排序顺序与ANSI标准的ASCII排序顺序相同：数字在大写字母字符之前排序，大写字母字符在小写字母字符之前排序。标点符号出现在序列中的多个位置。

这将导致如下所示的序列：

NULL
-2        /* 规范数排序 */
0
1
2
10
22
88
''         /* 空字符串 */
#          /* 逐个字符的字符串排序 */
-00        /* 非规范数字排序为字符串 */
0 Elm St.  /* 逐个字符的字符串排序 */
022        /* 非规范数字排序为字符串 */
1 Elm St.  
19 Elm St.

第五十二章 SQL函数 DEGREES

将弧度转换为角度的数值函数。

大纲

DEGREES(numeric-expression)

{fn DEGREES(numeric-expression)}

参数

• numeric-expression - 以弧度表示的角度的量度。解析为数值的表达式。

度返回NUMERIC或DOUBLE数据类型。如果NUMERIC-EXPRESSION的数据类型为DOUBLE，则度返回DOUBLE；否则返回NUMERIC。

度数可以指定为标准标量函数，也可以指定为使用大括号语法的ODBC标量函数。

描述

DEGREES以弧度为单位进行角度测量，并以度为单位返回相应的角度测量值。如果传递空值，度将返回空。

返回值的默认精度为36，默认小数位数为18。

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

示例

下面的嵌入式SQL示例返回与弧度值0到6对应的等价度：

ClassMethod Degrees()
{
	s a = 0
	while a < 7 {
		&sql(SELECT DEGREES(:a) INTO :b)
		if SQLCODE '= 0 {
			w !,"Error code ",SQLCODE
			q 
		} else {
			w !

第五十一章 SQL函数 DECODE

计算给定表达式并返回指定值的函数。

大纲

DECODE(expr {,search,result}[,default])

参数

• expr - 要解码的表达式。
• search - 要与Expr进行比较的值。
• result - Expr匹配搜索时返回的值。
• default - 可选-如果expr与任何搜索都不匹配，则返回默认值。

描述

可以指定多个搜索和结果对，以逗号分隔。您可以指定一个默认值。DECODE表达式(包括EXPR、SEARCH、RESULT和DEFAULT)中的最大参数数约为100。搜索、结果和默认值可以从表达式派生。

为了计算DECODE表达式，会逐个将expr与每个搜索值进行比较：

• 如果expr等于search ，则返回相应的结果。
• 如果expr不等于search ，则返回默认值，如果省略默认值，则返回NULL。

仅在将search与Expr进行比较之前计算每个search，而不是在将所有search与Expr进行比较之前评估所有search。因此，如果上一次搜索等于EXPR，不会对搜索求值。

在DECODE表达式中，将两个NULL视为等效。如果expr为NULL，则将返回同样为NULL的第一次搜索结果。

请注意，为了与Oracle兼容，支持解码。

返回值的数据类型

DECODE返回第一个结果参数的数据类型。

Hello 家人们，

    InterSystems 学习网站有许多非常棒的课程。 因此，如果您想了解 InterSystems 并开始使用 InterSystems，希望这些资源可以帮到你：

第五十章 SQL函数 DAYOFWEEK

Date函数，它返回日期表达式的整型日期。

参数

• date-expression - 日期表达式，它是列名、另一个标量函数的结果或日期或时间戳文字。

描述

DAYOFYEAR返回一个介于1到366之间的整数，该整数对应于给定日期表达式的一年中的第几天。DAYOFYAR计算闰年日期。

根据日期整数、$HOROLOG或$ZTIMESTAMP值、ODBC格式日期字符串或时间戳计算一年中的日期。

日期表达式时间戳可以是数据类型%Library.PosiTime(编码的64位有符号整数)或数据类型%Library.TimeStamp(yyyy-mm-dd hh：mm：ss.fff)。

时间戳的时间部分不计算，可以省略。

在计算$HOROLOG值的月份日期时，DAYOFYAR会计算闰年差异，包括世纪日调整：2000年是闰年，1900和2100不是闰年。

DAYOFYEAR可以将1840年12月31日之前的日期表达式值处理为负整数。下面的示例显示了这一点：

SELECT {fn DAYOFYEAR(-306)} AS LastDayFeb, 
       {fn DAYOFYEAR(-305)} AS FirstDayMar  
       
       
60	61

最早有效日期表达式为-672045(0001-01)。

第四十九章 SQL函数 DAYOFWEEK

Date函数，它返回日期表达式的整型星期几。

大纲

{fn DAYOFWEEK(date-expression)}

参数

• date-expression - 有效的ODBC格式日期或$HOROLOG格式日期，带或不带时间组件。作为列名、另一个标量函数的结果或日期或时间戳文字的表达式。

描述

DAYOFWEEK接受日期表达式，并返回与该日期的星期几对应的整数。一周的天数从一周的第一天开始计算；的默认设置是星期天是一周的第一天。因此，默认情况下，返回值表示这些天：

• 1 — Sunday
• 2 — Monday
• 3 — Tuesday
• 4 — Wednesday
• 5 — Thursday
• 6 — Friday
• 7 — Saturday

请注意，ObjectScript $ZDATE和$ZDATETIME函数计算一周中的天数从0到6(而不是1到7)。

日期表达式可以是日期整数、$HOROLOG或$ZTIMESTAMP值、ODBC格式的日期字符串或时间戳。

日期表达式时间戳可以是数据类型%Library.PosiTime(编码的64位有符号整数)或数据类型%Library.TimeStamp(yyyy-mm-dd hh：mm：ss.fff)。

时间戳的时间部分不被评估，可以省略。

可以使用DATEPART或TO_DATE函数返回星期几的信息。

第四十八章 SQL函数 DAYOFMONTH

返回日期表达式的月份日期的日期函数。

大纲

{fn DAYOFMONTH(date-expression)}

参数

• date-expression - 要从中返回月值日期的日期或时间戳表达式。作为列名、另一个标量函数的结果或日期或时间戳文字的表达式。

描述

DAYOFMONTH以1到31之间的整数形式返回每月的第几天。日期表达式可以是日期整数、$HOROLOG或$ZTIMESTAMP值、ODBC格式的日期字符串或时间戳。

日期表达式时间戳可以是数据类型%Library.PosiTime(编码的64位有符号整数)或数据类型%Library.TimeStamp(yyyy-mm-dd hh：mm：ss.fff)。

TIMESTAMP或$HOROLOG字符串的时间部分不计算，可以省略。

DAYOFMONTH和DAY函数在功能上是相同的。

也可以使用DAYOFMONTH（）方法调用从ObjectScript调用此函数：

DHC-APP>  w $SYSTEM.SQL.DAYOFMONTH("2018-02-25")
25

Timestamp date-expression

时间戳字符串的日(Dd)部分应该是介于1到31之间的整数。但是，不会对用户提供的值进行范围检查。按照指定的方式返回大于31的数字和分数。由于(-)用作分隔符，因此不支持负数。

第四十七章 SQL函数 DAYNAME

Date函数，它返回日期表达式的星期几的名称。

大纲

{fn DAYNAME(date-expression)}

参数

• date-expression - 计算结果为日期整数、ODBC日期或时间戳的表达式。该表达式可以是列名、另一个标量函数的结果或日期或时间戳文字。

描述

DAYNAME返回与指定日期对应的日期的名称。返回值为字符串，最大长度为15。默认返回的日期名称为：Sunday, Monday, Tuesday, Wednesday, Thursday, Friday, Saturday。

要更改这些默认日期名称值，请使用带有WEEKDAY_NAME选项的SET OPTION命令。

日期名称是针对日期整数、$HOROLOG或$ZTIMESTAMP值、ODBC格式日期字符串或时间戳计算的。

日期表达式时间戳可以是数据类型%Library.PosiTime(编码的64位有符号整数)或数据类型%Library.TimeStamp(yyyy-mm-dd hh：mm：ss.fff)。

时间戳的时间部分不计算，可以省略。

DAYNAME检查提供的日期是否为有效日期。年份必须介于0001和9999之间(包括0001和9999)、月01到12和适合该月的日期(例如，02/29仅在闰年有效)。如果日期无效，DAYNAME将发出SQLCODE-400错误(发生致命错误)。

第四十六章 SQL函数 DAY

返回日期表达式的月份日期的日期函数。

大纲

DAY(date-expression)

{fn DAY(date-expression)}

参数

• date-expression - 作为列名、另一个标量函数的结果或日期或时间戳文字的表达式。

描述

注意：DAY函数是DAYOFMONTH函数的别名。提供DAY是为了与TSQL兼容。

SELECT day("2022-02-28") AS day

28

SELECT day(+$h) AS day

5

第四十五章 SQL函数 DATEPART

日期/时间函数，返回表示日期/时间表达式指定部分的值的整数。

大纲

DATEPART(datepart,date-expression)

参数

• datepart - 要返回的日期/时间信息的类型。日期或时间部分的名称(或缩写)。这个名称可以用大写或小写来指定，有或没有引号。datepart可以指定为文字或主机变量。
• date-expression - 从中返回datepart值的日期、时间或时间戳表达式。日期表达式必须包含datepart类型的值。

描述

DATEPORT函数以整数数据类型返回关于指定日期/时间表达式的DATEPORT信息。唯一的例外是sqltimestamp (sts)，它以数据类型%Library.Timestamp返回。要以字符串形式返回日期部分信息，请使用DATENAME。

DATEPART只返回日期表达式中一个元素的值；要返回包含多个日期部分的字符串，请使用TO_DATE。

也可以使用DATEPART()方法调用从ObjectScript调用此函数:

$SYSTEM.SQL.Functions.DATEPART(datepart,date-expression)

提供DATEPART是为了与Sybase和Microsoft SQL Server兼容。

第四十四章 SQL函数 DATENAME

日期/时间函数，它返回一个字符串，表示日期/时间表达式中指定部分的值。

参数

• datepart - 要返回的日期/时间信息类型。 日期或时间部分的名称(或缩写)。 可以用大写或小写指定该名称，也可以不加引号。 可以将datepart指定为文字或主机变量。
• date-expression - 要返回datepart值的日期、时间或时间戳表达式。 日期表达式必须包含datepart类型的值。

描述

DATENAME函数返回日期/时间值中指定部分的名称(例如“June”)。 结果作为数据类型VARCHAR(20)返回。 如果结果是数字(例如“23”表示当天)，它仍然作为VARCHAR(20)字符串返回。 要以整数形式返回此信息，请使用DATEPART。 要返回包含多个日期部分的字符串，请使用TO_DATE。

请注意，DATENAME是为Sybase和Microsoft SQL Server兼容性而提供的。

这个函数也可以通过调用DATENAME()方法从ObjectScript调用:

$SYSTEM.SQL.Functions.DATENAME(datepart,date-expression)

Datepart 参数

datepart参数可以是包含一个(且仅包含一个)以下日期/时间组件的字符串，可以是全名(date Part列)，也可以是缩写(缩写列)。

[toc]

第四十三章 SQL函数 DATEDIFF

日期/时间函数，返回两个日期之间指定日期部分的整数差。

大纲

DATEDIFF(datepart,startdate,enddate)

参数

• datepart - 日期或时间部分的名称(或缩写)。这个名称可以用大写或小写来指定，有或没有引号。datepart可以指定为文字或主机变量。
• startdate - 间隔的开始日期/时间。可以是各种标准格式的日期、时间或日期时间。
• enddate - 间隔的结束日期/时间。可以是各种标准格式的日期、时间或日期时间。从enddate中减去startdate，以确定两个日期之间的日期部分间隔。

描述

DATEDIFF函数返回两个指定日期之间指定日期部分差的整数。日期范围从开始日期开始，到结束日期结束。(如果enddate早于startdate，DATEDIFF将返回一个负整数值。)

DATEDIFF返回startdate和enddate之间指定单位的总数。例如，两个日期时间值之间的分钟数计算日期部分和时间部分，并为每一天的差异增加1440分钟。DATEDIFF返回开始日期和结束日期之间跨越的指定日期部分边界的计数。例如，指定连续年份的任意两个日期(例如2018-09-23和2019-01-01)返回的年份DATEDIFF为1，而不管这两个日期之间的实际持续时间是大于还是小于365天。

第四十二章 SQL函数 DATEADD

一个日期/时间函数，它返回一个时间戳，计算方法是在一个日期或时间戳中添加或减去若干日期部件单位(如小时或天)。

大纲

DATEADD(datepart,integer-exp,date-exp)

参数

• datepart - 日期或时间部分的名称(或缩写)。 可以用大写或小写指定该名称，也可以不加引号。 可以将datepart指定为文字或主机变量。
• integer-exp - 任意数字类型的数字表达式。 该值被截断为整数(正或负)。 该值指示将添加到(或从)date-exp中减去的datepart单元的数量。
• date-exp - 要修改的日期/时间表达式。它可以是日期字符串，也可以是时间戳字符串(%PosiTime或%Timestamp数据类型)，也可以是CURRENT_DATE之类的函数。返回的值始终是时间戳，数据类型格式为%PosiTime或%Timestamp。

描述

DATEADD函数通过将指定的日期部分递增指定的单元数来修改日期/时间表达式。 例如，如果datepart为“month”且整数-exp为5，则DATEADD将date-exp递增5个月。 还可以通过为integer-exp指定一个负整数来减少日期部分。

计算出的日期将作为完整的日期/时间表达式(时间戳)返回。返回的数据类型取决于Date-EXP的数据类型。

第四十一章 SQL函数 DATE

接受时间戳并返回日期的函数。

大纲

DATE(timestamp)

参数

• timestamp - 指定时间戳或其他日期或日期和时间表示形式的表达式。

描述

Date接受时间戳表达式并返回日期。返回值的数据类型为Date。这在功能上与CAST相同(时间戳与日期相同)。它接受具有以下任何数据类型类(或其子类)的时间戳值：%Library.TimeStamp、%Library.PosiTime、%Library.Date和%Library.Integer或%Library.Numerical(用于隐式逻辑日期，如+$HOROLOG)。它还可以接受格式与%Library.TimeStamp(有效的ODBC日期)兼容的%Library.String值。

无效的ODBC日期字符串的计算结果为零，与日期1840年12月31日相对应。时间戳可以只包含ODBC格式的日期或ODBC格式的日期和时间。虽然只转换ODBC时间戳的日期部分，但会验证整个字符串。如果日期部分不完整、日期或时间部分包含超出范围的值(包括闰年计算)，或者时间戳包含任何无效的格式字符或尾随字符，则ODBC时间戳验证失败。

空字符串(‘’)参数返回0(1840年12月31日)。NULL参数返回NULL。

第四十章 SQL函数 DATALENGTH

返回表达式中字符数的函数。

大纲

DATALENGTH(expression)

参数

• expression - 表达式，可以是列的名称、字符串字面值或另一个标量函数的结果。 基础数据类型可以是字符类型(如CHAR或VARCHAR)、数字或数据流。

DATALENGTH返回INTEGER数据类型。

描述

注意:DATALENGTH、CHAR_LENGTH和CHARACTER_LENGTH函数是相同的。 对于新代码，建议使用CHAR_LENGTH函数。 DATALENGTH是为TSQL兼容性而提供的。

第三十九章 SQL函数 DATABASE

返回数据库名称限定符的标量字符串函数。

大纲

{fn DATABASE()}

描述

DATABASE返回与连接句柄对应的数据库名称的当前限定符。 在IRIS中，DATABASE总是返回空字符串(")。

第三十八章 SQL函数 CURTIME

返回当前本地时间的标量日期/时间函数。

大纲

{fn CURTIME()}
{fn CURTIME}

描述

``不接受任何参数。它将当前本地时间作为数据类型TIME返回。请注意，参数括号是可选的。CURTIME返回此时区的当前本地时间；它根据本地时间变量(如夏令时)进行调整。

逻辑模式下的CURTIME以$HOROLOG格式返回当前本地时间; 例如,37065年。 显示模式下的CURTIME以区域设置的默认格式返回当前本地时间; 例如,10:18:27。

小时以24小时格式表示。

要更改默认的时间格式，使用SET OPTION命令和TIME_FORMAT和TIME_PRECISION选项。

要只返回当前时间，请使用CURTIME或CURRENT_TIME。 这些函数以TIME数据类型返回它们的值。 CURRENT_TIMESTAMP、GETDATE和NOW函数也可以作为TIMESTAMP数据类型返回当前日期和时间。

请注意，除了GETUTCDATE之外，所有 SQL时间和日期函数都特定于当地时区设置。 要获得通用的(独立于时区的)当前时间戳，你可以使用GETUTCDATE或ObjectScript $ZTIMESTAMP特殊变量。

在使用嵌入式SQL时，这些数据类型的性能不同。

第三十七章 SQL函数 CURRENT_TIMESTAMP

日期/时间函数，返回当前本地日期和时间。

大纲

CURRENT_TIMESTAMP
CURRENT_TIMESTAMP(precision)

参数

• precision - 一个正整数，它将时间精度指定为小数秒的位数。 默认值是0(没有小数秒); 这个默认值是可配置的。

CURRENT_TIMESTAMP返回TIMESTAMP数据类型。

描述

CURRENT_TIMESTAMP要么不接受参数，要么接受精度参数。 不允许使用空参数括号。

CURRENT_TIMESTAMP返回当前时区的本地日期和时间; 它会根据当地的时间变化进行调整，例如日光节约时间。

CURRENT_TIMESTAMP可以返回%timestamp数据类型格式(yyyy-mm-dd hh:mm:ss.ffff)或%PosixTime数据类型格式(编码的64位带符号整数)的时间戳。 以下规则决定返回哪种时间戳格式:

1. 如果将当前时间戳提供给数据类型为%PosixTime的字段，则当前时间戳值将以PosixTime数据类型格式返回。 例如，WHERE PosixField=CURRENT_TIMESTAMP or INSERT INTO MyTable (PosixField) VALUES (CURRENT_TIMESTAMP).

第三十六章 SQL函数 CURRENT_TIME

返回当前本地时间的日期/时间函数。

大纲

CURRENT_TIME
CURRENT_TIME(precision)

参数

• precision - 一个正整数，它将时间精度指定为小数位数。默认值为0(无小数秒)；此默认值是可配置的。

CURRENT_TIME返回时间数据类型。

描述

CURRENT_TIME要么不带参数，要么带精度参数。不允许使用空参数括号。

CURRENT_TIME返回此时区的当前本地时间。它会根据当地时间变化(如夏令时)进行调整。

逻辑模式下的CURRENT_TIME以$HOROLOG格式返回当前本地时间；例如，37065。显示模式下的当前时间以区域设置的默认格式返回当前本地时间；例如，10:18:27。

要更改默认时间格式，请使用带有time_format和time_PRECISION选项的SET OPTION命令。可以配置分数秒的精度，如下所述。

要仅返回当前时间，请使用CURRENT_TIME或CURTIME。这些函数以时间数据类型返回它们的值。CURRENT_TIMESTAMP、GETDATE和NOW函数也可用于将当前日期和时间作为TIMESTAMP数据类型返回。

请注意，除GETUTCDATE之外，所有 SQL时间和日期函数都特定于本地时区设置。

第三十五章 SQL函数 CURRENT_DATE

日期/时间函数，返回当前本地日期。

大纲

CURRENT_DATE

描述

CURRENT_DATE不带任何参数。它将当前本地日期作为数据类型DATE返回。不允许使用参数括号。CURRENT_DATE返回此时区的当前本地日期；它根据本地时间变量(如夏令时)进行调整。

在逻辑模式下CURRENT_DATE以$HOROLOG格式返回当前本地日期; 例如,64701。 显示模式下的CURRENT_DATE以区域设置的默认格式返回当前本地日期。 例如，在美国的区域设置为02/22/2018，在欧洲的区域设置为22/02/2018，在俄罗斯的区域设置为22.02.2018。

要指定不同的日期格式，请使用TO_DATE函数。要更改默认日期格式，请将SET OPTION命令与DATE_FORMAT、Year_OPTION或DATE_SEFACTOR选项配合使用。

要仅返回当前日期，请使用CURRENT_DATE或CURDATE。这些函数以DATE数据类型返回它们的值。CURRENT_TIMESTAMP、GETDATE和NOW函数也可用于将当前日期和时间作为TIMESTAMP数据类型返回。

请注意，除GETUTCDATE之外，所有 SQL时间和日期函数都特定于本地时区设置。

第三十四章 SQL函数 CURDATE

返回当前本地日期的标量日期/时间函数。

大纲

{fn CURDATE()}
{fn CURDATE}

描述

CURDATE不接受任何参数。它将当前本地日期作为数据类型DATE返回。请注意，参数括号是可选的。CURDATE返回此时区的当前本地日期；它根据本地时间变量(如夏令时)进行调整。

逻辑模式下的CURDATE以$HOROLOG格式返回当前本地日期; 例如,64701。 显示模式下的CURDATE以区域设置的默认格式返回当前本地日期。 例如，在美国的区域设置为02/22/2018，在欧洲的区域设置为22/02/2018，在俄罗斯的区域设置为22.02.2018。

要指定不同的日期格式，请使用TO_DATE函数。 要更改默认的日期格式，使用SET OPTION命令和DATE_FORMAT、YEAR_OPTION或DATE_SEPARATOR选项。

要只返回当前日期，请使用CURDATE或CURRENT_DATE。 这些函数返回DATE数据类型的值。 CURRENT_TIMESTAMP、GETDATE和NOW函数也可以作为TIMESTAMP数据类型返回当前日期和时间。

请注意，除了GETUTCDATE之外，所有 SQL时间和日期函数都特定于当地时区设置。

第三十三章 SQL函数 COT

标量数值函数，返回角度的余切值(以弧度为单位)。

大纲

{fn COT(numeric-expression)}

参数

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

COT返回NUMERIC或DOUBLE数据类型。 如果数值表达式是数据类型DOUBLE, COT返回DOUBLE; 否则，返回NUMERIC。

描述

COT接受任何非零数，并以浮点数的形式返回它的余切值。 如果传入NULL值，COT将返回NULL。 数值0(0)会导致运行时错误，生成SQLCODE -400(发生致命错误)。 COT将非数字字符串视为数值0。

COT返回一个精度为36、刻度为18的值。

COT只能用作ODBC标量函数(使用花括号语法)。

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

示例

下面的例子展示了COT的效果:

SELECT {fn COT(0.52)} AS Cotangent 

1.746536264145397165

SELECT {fn COT(124.1332)} AS Cotangent 

-0.040311998371146672

第三十二章 SQL函数 COS

标量数值函数，返回一个角的余弦值(以弧度为单位)。

大纲

{fn COS(numeric-expression)}

参数

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

COS返回NUMERIC或DOUBLE数据类型。 如果数值表达式是数据类型DOUBLE, COS返回DOUBLE; 否则，返回NUMERIC。

描述

COS接受任何数值，并以浮点数的形式返回COS。 返回值的范围是-1到1(含1)。 如果传入NULL值，COS将返回NULL。 COS将非数字字符串视为数值0。

COS返回一个精度为19、刻度为18的值。

COS只能用作ODBC标量函数(使用花括号语法)。

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

示例

这些例子说明了COS对两个正弦函数的影响。

SELECT {fn COS(0.52)} AS Cosine

0.8678191796776499

SELECT {fn COS(-.31)} AS Cosine 

SELECT {fn COS(-.31)} AS Cosine 

第三十一章 SQL函数 CONVERT

将给定表达式转换为指定数据类型的函数。

CONVERT(datatype,expression[,format-code])

{fn CONVERT(expression,datatype)}

参数

• expression - 要转换的表达式。
• datatype - 要将表达式转换为的数据类型。
• format - 可选-指定日期和时间格式的整数代码，用于在日期/时间/时间戳数据类型和字符数据类型之间进行转换。 此参数仅用于通用标量语法形式。

描述

这里描述了CONVERT函数的两种不同实现。 两者都将一种数据类型中的表达式转换为另一种数据类型中的相应值。 两者都执行日期和时间转换。

注意:这两个CONVERT实现中的参数以不同的顺序表示。 第一个是与MS SQL Server兼容的通用 IRIS标量函数，它接受三个参数。 第二个是带有两个参数的 ODBC标量函数。 下面的文本将分别处理这两种形式的CONVERT。

• CONVERT(datatype,expression)支持流数据的转换。 例如，可以将字符流字段的内容转换为数据类型为VARCHAR的字符串。
• {fn CONVERT(expression,datatype)}不支持流数据的转换; 指定要表达的流字段将导致SQLCODE -37错误。

第三十章 SQL函数 CONCAT

标量字符串函数，它返回作为连接两个字符表达式的结果的字符串。

大纲

{fn CONCAT(string-expression1,string-expression2)}

参数

• string-expression1, string-expression2 - 要连接的字符串表达式。表达式可以是列名、字符串文字、数字或另一个标量函数的结果，其中底层数据类型可以表示为任何字符类型(如CHAR或VARCHAR)。

描述

连接两个字符串以返回连接的字符串。可以使用连接运算符(||)执行完全相同的操作。

可以连接数字或数字字符串的任意组合；连接结果是一个数字字符串。SQL在连接之前将数字转换为规范形式(指数被扩展，前导零和尾随零被删除)。在连接之前，数字字符串不会转换为规范形式。

可以将前导空格或尾随空格连接到字符串。将空值连接到字符串会产生空值；这是行业范围内的SQL标准。

字符串函数还可用于将两个或多个表达式连接成单个字符串。

示例

以下示例连接Home_State和Home_City列以创建位置值。使用CONCAT函数和concatenate运算符显示两次连接：

SELECT {fn CONCAT(Home_State,Home_City)} AS LocationFunc,
Home_State||Home_City AS LocationOp
FROM Sample.

第二十九章 SQL函数 COALESCE

返回第一个非空表达式的值的函数。

大纲

COALESCE(expression,expression [,...])

• expression - 要计算的一系列表达式。多个表达式被指定为逗号分隔的列表。此表达式列表限制为140个表达式。

描述

COALESSE函数按从左到右的顺序计算表达式列表，并返回第一个非空表达式的值。如果所有表达式的计算结果都为NULL，则返回NULL。

字符串返回时保持不变；保留前导和尾随空格。数字以规范形式返回，去掉了前导零和尾随零。

返回值的数据类型

非数字表达式(如字符串或日期)必须都属于相同的数据类型，并返回该数据类型的值。指定数据类型不兼容的表达式会导致SQLCODE-378错误，并显示DataType不匹配错误消息。可以使用CAST函数将表达式转换为兼容的数据类型。

数值表达式可以是不同的数据类型。如果指定具有不同数据类型的数值表达式，则返回的数据类型是与所有可能的结果值最兼容的表达式数据类型，即具有最高数据类型优先级的数据类型。

文字值(字符串、数字或NULL)被视为数据类型VARCHAR。如果只指定两个表达式，则文字值与数值表达式兼容：如果第一个表达式是数值表达式，则返回其数据类型；如果第一个表达式是文字值，则返回VARCHAR数据类型。

比较NULL处理函数

第二十八章 SQL函数 CHAR_LENGTH

返回表达式中的字符数的函数。

大纲

CHAR_LENGTH(expression)

参数

• expression - 表达式，可以是列名、字符串文字或另一个标量函数的结果。底层数据类型可以是字符类型(如CHAR或VARCHAR)、数字或数据流。

CHAR_LENGTH返回整数数据类型。

描述

CHAR_LENGTH返回一个整数值，表示指定表达式中的字符数，而不是字节数。表达式可以是字符串，也可以是任何其他数据类型，如数字或数据流字段。返回的整数计数包括前导和尾随空格以及字符串终止字符。如果传递NULL值，则CHARACTER_LENGTH返回NULL，如果传递空字符串(‘’)值，则返回0。

在计算字符之前，会将数字解析为规范形式；不会解析带引号的数字字符串。在下面的示例中，第一个CHAR_LENGTH返回1(因为数字分析删除了前导和尾随零)，第二个CHAR_LENGTH返回8。

SELECT CHAR_LENGTH(007.0000) AS NumLen,
       CHAR_LENGTH('007.0000') AS NumStringLen
       
1   8

注意：CHAR_LENGTH、CHARACTER_LENGTH和DATALENGTH函数是相同的。 它们都接受一个流字段参数。

第二十七章 SQL函数 CHARINDEX

一个字符串函数，它返回子字符串在字符串中的位置，具有可选的搜索起点。

大纲

CHARINDEX(substring,string[,start])

参数

• substring - 要在字符串中匹配的子字符串。
• string - 作为子字符串搜索目标的字符串表达式。
• start - 可选-子字符串搜索的起始点，指定为正整数。 从字符串开始的字符计数，从1开始计数。 若要从字符串的开头开始搜索，请忽略此参数或指定从0或1开始。 负数、空字符串、NULL或非数字值被视为0。

CHARINDEX返回INTEGER数据类型。

描述

CHARINDEX在字符串中搜索子字符串。 如果找到匹配，则返回第一个匹配子字符串的起始位置，从1开始计算。 如果不能找到子字符串，CHARINDEX返回0。

空字符串是一个字符串值。 因此，可以将空字符串用于任意一个字符串参数值。 start参数将空字符串值视为0。 但是，请注意ObjectScript空字符串作为NULL传递给 SQL。

NULL不是SQL中的字符串值。 因此，为任何一个CHARINDEX字符串参数指定NULL都会返回NULL。

CHARINDEX不能将%Stream.GlobalCharacter字段用于字符串或子字符串参数。尝试这样做会生成SQLCODE-37错误。可以使用SUBSTRING函数获取%Stream.

第二十五章 SQL函数 CHAR

返回具有在字符串表达式中指定的ASCII代码值的字符的字符串函数。

大纲

CHAR(code-value)

{fn CHAR(code-value)}

参数

• code-value - 与字符相对应的整数代码。

描述

Char返回与指定的整数代码值对应的字符。因为 IRIS是UNICODE系统，所以可以为任何UNICODE字符指定整数代码，从0到65535。如果code-value是超出允许值范围的整数，则CHAR返回NULL。

如果代码值是非数字字符串，则CHAR返回一个空字符串（''）。如果传递空值，CHAR返回NULL。

请注意，CHAR可以用作ODBC标量函数(使用花括号语法)，也可以用作SQL常规函数。

示例

以下示例均返回字符Z：

SELECT CHAR(90) AS CharCode

Z

SELECT {fn CHAR(90)} AS CharCode

Z

下面的示例返回希腊字母lambda：

ClassMethod Cast2()
{
	&sql(SELECT {fn CHAR(955)}
	   INTO :greeklet)
	w !,"Greek letter: ",greeklet
}

DHC-APP> d ##class(PHA.TEST.SQLCommand).Cast2()
 
Greek letter: λ

第二十四章 SQL函数 CEILING

数值函数，返回大于或等于给定数值表达式的最小整数。

大纲

CEILING(numeric-expression)

{fn CEILING(numeric-expression)}

参数

• numeric-expression - 要计算其上限的数字。

CELING返回与NUMERIC-EXPRESSION相同的数据类型。

描述

CELING返回大于或等于NUMERIC-EXPRESSION的最接近的整数值。返回值的小数位数为0。当numeric-expression为NULL值、空字符串(‘’)或任何非数字字符串时，CELING返回NULL。

请注意，CELING可以作为ODBC标量函数(使用花括号语法)调用，也可以作为SQL常规函数调用。

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

$SYSTEM.SQL.Functions.EILING(numeric-expression)

示例

以下示例显示了CEILING 如何将分数转换为其CEILING 整数：

SELECT CEILING(167.111) AS CeilingNum1,
       CEILING(167.456) AS CeilingNum2,
       CEILING(167.