第八十一章 SQL函数 $LISTBUILD

从字符串构建列表的列表函数。

大纲

$LISTBUILD(element [,...])

参数

• element - 任何表达式，或逗号分隔的表达式列表

描述

$LISTBUILD 接受一个或多个表达式，并为每个表达式返回一个包含一个元素的列表。

以下函数可用于创建列表：

• $LISTBUILD，它从多个字符串创建一个列表，每个元素一个字符串。
• $LISTFROMSTRING，它从包含多个分隔元素的单个字符串创建一个列表。
• $LIST，从现有列表中提取子列表。

$LISTBUILD 与其他 SQL 列表函数一起使用：$LIST、$LISTDATA、$LISTFIND、$LISTFROMSTRING、$LISTGET、$LISTLENGTH 和 $LISTTOSTRING。

注意：$LISTBUILD 和其他 $LIST 函数使用优化的二进制表示来存储数据元素。出于这个原因，等效性测试可能无法对某些 $LIST 数据按预期工作。在其他情况下可能被视为等效的数据可能具有不同的内部表示。例如，$LISTBUILD(1) 不等于 $LISTBUILD('1')。

出于同样的原因，$LISTBUILD 返回的列表字符串值不应用于使用分隔符的字符搜索和解析函数，例如 $PIECE 和 $LENGTH

第八十章 SQL函数 $LIST（二）

示例

在以下嵌入式 SQL 示例中，两个 WRITE 语句都返回“Red”，即列表中的第一个元素。第一个默认写入第一个元素，第二个写入第一个元素，因为位置参数设置为 1：

/// d ##class(PHA.TEST.SQLFunction).Li4()
ClassMethod Li4()
{
	s a = $lb("Red", "Blue", "Green")
	&sql(SELECT $LIST(:a), $LIST(:a,1)
		INTO :b,:c )
	if SQLCODE '= 0 {
		w !,"Error code ",SQLCODE 
	} else {
		w !,"The one-arg sublist is ",b
		w !,"The two-arg sublist is ",c }
}

DHC-APP>d ##class(PHA.TEST.SQLFunction).Li4()
 
The one-arg sublist is Red
The two-arg sublist is Red

以下嵌入式 SQL 示例返回列表中的第二个元素“Blue”：

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

第七十九章 SQL函数 $LIST（一）

返回列表中元素的列表函数。

大纲

$LIST(list[,position[,end]])

参数

• list - 计算结果为有效列表的表达式。列表是包含一个或多个元素的编码字符串。可以使用 SQL 或 ObjectScript 的 $LISTBUILD 或 $LISTFROMSTRING 函数创建列表。可以使用 SQL 或 ObjectScript $LIST 函数从现有列表中提取列表。
• position - 可选 - 指定列表中的起始位置。计算结果为整数的表达式。
• end - 可选 - 指定列表中的结束位置。计算结果为整数的表达式。

描述

$LIST 从列表中返回元素。返回的元素取决于使用的参数。

• $LIST(list) 将列表中的第一个元素作为文本字符串返回。
• $LIST(list,position) 将指定位置指示的元素作为文本字符串返回。位置参数必须计算为整数。
• $LIST(list,position,end) 返回一个“子列表”（编码的列表字符串），其中包含从指定开始位置到指定结束位置的列表元素。

此函数返回 VARCHAR 类型的数据。

参数

list

包含一个或多个元素的编码字符串。可以使用 SQL $LISTBUILD 函数或 ObjectScript $LISTBUILD 函数创建列表。

第七十八章 SQL函数 $LENGTH

返回字符串中字符数或分隔子字符串数的字符串函数。

大纲

$LENGTH(expression[,delimiter])

参数

• expression - 目标字符串。它可以是数值、字符串文字、任何变量的名称或任何有效的表达式。
• delimiter - 可选 — 在目标字符串中划分不同子字符串的字符串。它必须是字符串文字，但可以是任意长度。括起来的引号是必需的。

$LENGTH 返回 SMALLINT 数据类型。

描述

$LENGTH 返回指定字符串中的字符数或指定字符串中的子字符串数，具体取决于使用的参数。

• $LENGTH(expression) 返回字符串中的字符数。如果表达式为空字符串 ('')，则 $LENGTH 返回 0。如果表达式为 NULL，则 $LENGTH 返回 0。
• $LENGTH(expression,delimiter) 返回字符串中子字符串的数量。 $LENGTH 返回由指定分隔符相互分隔的子字符串的数量。此数字始终等于在表达式字符串中找到的分隔符实例的数量加一。

第七十七章 SQL函数 LENGTH

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

大纲

LENGTH(string-expression)

{fn LENGTH(string-expression)}

参数

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

LENGTH 返回 INTEGER 数据类型。

描述

LENGTH 返回一个整数，表示给定字符串表达式的字符数，而不是字节数。字符串表达式可以是字符串（从中删除尾随空格）或数字（ IRIS 将其转换为规范形式）。

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

LENGTH 和其他长度函数（$LENGTH、CHARACTER_LENGTH、CHAR_LENGTH 和 DATALENGTH）都执行以下操作：

• LENGTH 返回字段的逻辑（内部数据存储）值的长度，而不是显示值，无论 SelectMode 设置如何。所有 SQL 函数始终使用字段的内部存储值。
• LENGTH 返回数字的规范形式的长度。规范形式的数字不包括前导零和尾随零、前导符号（单个减号除外）和尾随小数分隔符。 LENGTH 返回数字字符串的字符串长度。数字字符串不会转换为规范形式。

第七十六章 SQL函数 LEN

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

大纲

LEN(string-expression)

参数

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

LEN 返回 INTEGER 数据类型。

描述

注意：LEN 函数是 LENGTH 函数的别名。

SELECT len("yaoxin")  

6

第七十五章 SQL函数 LEFT

标量字符串函数，返回从字符串表达式的开始(最左位置)开始的指定数量的字符。

大纲

{fn LEFT(string-expression,count)}

参数

• string-expression - 字符串表达式，它可以是列的名称、字符串字面值或另一个标量函数的结果，其中基础数据类型可以表示为任何字符类型(如CHAR或VARCHAR)。
• count - 整数，指定从字符串表达式的起始位置返回的字符数。

描述

LEFT返回从字符串开始的指定字符数。 LEFT不填充字符串; 如果指定的字符数大于字符串中的字符数，则LEFT返回该字符串。 如果传递给任何一个参数一个NULL值，左返回NULL。

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

示例

以下示例返回 Sample.Person 表中每个名称的最左边的七个字符：

SELECT Name,{fn LEFT(Name,7)}AS ShortName
     FROM Sample.Person

以下嵌入式 SQL 示例显示了 LEFT 如何处理比字符串本身长的计数：

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

第七十四章 SQL函数 LEAST

从一系列表达式中返回最小值的函数。

大纲

LEAST(expression,expression[,...])

参数

• expression - 解析为数字或字符串的表达式。 将这些表达式的值相互比较，并返回最小值。 表达式可以是字段名、文字、算术表达式、主机变量或对象引用。 最多可以列出140个逗号分隔的表达式。

描述

LEAST从逗号分隔的表达式序列中返回最小值。 表达式按从左到右的顺序求值。 如果只提供一个表达式，则LEAST返回该值。 如果任何表达式为NULL, LEAST返回NULL。

如果所有表达式值都解析为规范数，则按数值顺序对它们进行比较。 如果引用的字符串包含规范格式的数字，则按数字顺序对其进行比较。 但是，如果引用的字符串包含非规范格式的数字(例如，'00'、'0.4'或'+4')，则将其作为字符串进行比较。 字符串比较按排序顺序逐字符执行。 任何字符串值都大于任何数字值。

空字符串大于任何数字值，但小于任何其他字符串值。

如果返回值是一个数字，LEAST将以规范格式返回它(删除前导和末尾的零，等等)。 如果返回值是一个字符串，LEAST将不改变返回值，包括任何开头或结尾的空格。

LEAST返回逗号分隔的一系列表达式中的最小值。 GREATEST

第七十三章 SQL函数 LCASE

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

大纲

LCASE(string-expression)

{fn LCASE(string-expression)}

参数

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

描述

LCASE将大写字母转换为小写字母用于显示。 它对非字母字符没有影响。 它保留没有改变的标点符号以及前导和末尾的空格。

LCASE不强制将数字解释为字符串。 SQL将数字转换为规范形式，删除前导和后导零。 SQL不将数字字符串转换为规范形式。

LOWER函数也可以用来将大写字母转换为小写字母。

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

示例

下面的例子以小写字母返回每个人的名字:

SELECT TOP 10 Name,{fn LCASE(Name)} AS LowName
     FROM Sample.Person

LCASE也适用于Unicode(非ascii)字母字符，如下面的嵌入式SQL示例所示，它将希腊字母从大写转换为小写:

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

第七十二章 SQL函数 LAST_IDENTITY

返回最后插入、更新、删除或读取的行的标识的标量函数。

大纲

LAST_IDENTITY()

描述

LAST_IDENTITY函数返回%ROWID局部变量值。在嵌入式SQL或ODBC中将%ROWID局部变量设置为一个值。动态SQL、SQL Shell或管理门户SQL界面未将%ROWID局部变量设置为值。动态SQL改为设置%ROWID对象属性。

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

LAST_IDENTITY返回受当前进程影响的最后一行的标识字段值。如果表没有标识字段，则返回受当前进程影响的最后一行的行ID(%ROWID)。返回值为数据类型INTEGER。

• 对于嵌入式SQL INSERT、UPDATE、DELETE或TRUNCATE TABLE语句，LAST_IDENTITY返回最后修改的行的IDENTITY或%ROWID值。
• 对于嵌入式SQL基于游标的SELECT语句，LAST_IDENTITY返回检索到的最后一行的IDENTITY或%ROWID值。但是，如果基于游标的SELECT语句包括DISTINCT关键字或GROUP BY子句，则LAST_IDENTITY不会更改；它将返回其先前的值(如果有)。
• 对于嵌入式SQL单行(非游标)SELECT语句，LAST_IDENTITY不会更改。返回先前的值(如果有)。

第七十一章 SQL函数 LAST_DAY

日期函数，它为日期表达式返回一个月的最后一天的日期。

大纲

LAST_DAY(date-expression)

参数

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

描述

LAST_DAY以整数形式返回指定月份的最后一天，格式为$HOROLOG。 计算闰年差异，包括世纪日调整:2000是闰年，1900和2100不是闰年。

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

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

%TIMESTAMP字符串的时间部分是可选的。

指定无效日期时，LAST_DAY返回0(显示模式为12/31/1840)：日或月为零；大于12的月；或大于当年该月天数的日。年份必须在0001到9999之间。

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

  WRITE $SYSTEM.SQL.Functions.LASTDAY("2018-02-22"),!
  WRITE $SYSTEM.SQL.Functions.

第七十章 SQL函数 $JUSTIFY

在指定宽度内右对齐值的函数，可以选择舍入到指定的小数位数。

大纲

$JUSTIFY(expression,width[,decimal])

参数

• expression - 要右对齐的值。它可以是数字值、字符串文字或解析为数字或字符串的表达式。
• width - 表达式要在其中右对齐的字符数。正整数或计算结果为正整数的表达式。
• decimal - 可选-小数位数。正整数或计算结果为正整数的表达式。将表达式中的小数位数四舍五入或填充到此值。如果指定DECIMAL，会将表达式视为数字。

描述

$JUSTIFY返回在指定宽度内右对齐的表达式指定的值。可以包括小数参数以在宽度内小数对齐数字。

• $JUSTUST(expression,width)：双参数语法在宽度内右对齐表达式。它不执行任何表达式转换。该表达式可以是数字字符串，也可以是非数字字符串。
• $JUSTUST(expression,width,decimal)：3参数语法将表达式转换为规范数字，将小数位四舍五入或零填充为小数，然后在宽度内右对齐生成的数值。如果表达式是非数字字符串或NULL，会将其转换为0，填充，然后右对齐。

$JUSTIFY识别当前区域设置的DecimalSeparator字符。 它根据需要添加或删除DecimalSeparator字符。

第六十九章 SQL函数 JSON_OBJECT

将数据作为JSON对象返回的转换函数。

大纲

JSON_OBJECT(key:value [,key:value][,...] [NULL ON NULL | ABSENT ON NULL])

参数

• key:value - 键：值对或逗号分隔的键：值对列表。键是由单引号分隔的用户指定的文字字符串。值可以是列名、聚合函数、算术表达式、数字或字符串文字或文字NULL。
• ABSENT ON NULL NULL ON NULL - 可选-指定如何在返回的JSON对象中表示空值的关键字短语。NULL ON NULL(缺省值)表示带有单词NULL(未引号)的NULL(缺少)数据。在NULL上缺失将从JSON对象中省略NULL数据；当value为NULL且不保留占位符逗号时，它将删除key：value对。此关键字短语对空字符串值没有影响。

描述

JSON_OBJECT接受逗号分隔的键：值对列表(例如，‘MyKey’：colname)，并返回包含这些值的JSON对象。可以指定任何单引号字符串作为键名；JSON_OBJECT不强制任何命名约定或对键名进行唯一性检查。可以为值指定列名或其他表达式。

JSON_OBJECT可以在SELECT语句中与其他类型的SELECT-Items

第六十八章 SQL函数 JSON_ARRAY

以JSON数组形式返回数据的转换函数。

大纲

JSON_ARRAY(expression [,expression][,...] [NULL ON NULL | ABSENT ON NULL])

参数

• expression - 表达式或逗号分隔的表达式列表。这些表达式可以包括列名、聚合函数、算术表达式、文字和文字NULL。
• ABSENT ON NULL NULL ON NULL - 可选-指定如何在返回的JSON数组中表示空值的关键字短语。NULL ON NULL(缺省值)表示带有单词NULL(未引号)的NULL(缺少)数据。在NULL上不存在将从JSON数组中省略空数据；它不会保留占位符逗号。此关键字短语对空字符串值没有影响。

描述

Json_array接受表达式或(更常见的)逗号分隔的表达式列表，并返回包含这些值的JSON数组。Json_array可以在SELECT语句中与其他类型的SELECT-Items结合使用。可以在可以使用SQL函数的其他位置指定json_array，例如在WHERE子句中。

返回的JSON数组格式如下：

[ element1 , element2 , element3 ]

Json_array以字符串(用双引号括起来)或数字形式返回每个数组元素值。数字以规范格式返回。

第六十七章 SQL函数 ISNUMERIC

测试有效数字的数值函数。

大纲

ISNUMERIC(check-expression)

参数

• check-expression - 要计算的表达式。

ISNUMERIC返回SMALLINT数据类型。

描述

ISNUMERIC计算check-expression并返回下列值之一：

• 如果check表达式是有效数字，则返回1。有效数字可以是数字表达式，也可以是表示有效数字的字符串。
  • 数值表达式首先转换为规范形式，解析多个前导符号；因此，诸如+-+34这样的数值表达式是有效的数字。
  • 在求值之前不会转换数字字符串。数字字符串最多只能有一个前导符号才能计算为有效数字。带有尾随小数点的数字字符串的计算结果为有效数字。
• 如果check-expression不是有效数字，则返回0。任何包含非数字字符的字符串都不是有效数字。具有多个前导符号的数字字符串(如‘+-+34’)不会被计算为有效数字。编码列表始终返回0，即使其元素是有效数字也是如此。空字符串ISNUMERIC(‘’)返回0。
• 如果check-expression为NULL，则返回NULL。ISNUMERIC(NULL)返回NULL。

如果科学记数法指数大于308(308-(整数数-1))，ISNUMERIC会生成SQLCODE-7，指数超出范围错误。

第六十六章 SQL函数 ISNULL

测试NULL并返回相应表达式的函数。

大纲

ISNULL(check-expression,replace-expression)

参数

• check-expression - 要计算的表达式。
• replace-expression - Check-Expression为NULL时返回的表达式。

ISNULL返回与Check-Expression相同的数据类型。

描述

ISNULL计算check-expression并返回以下两个值之一：

• 如果check-expression为NULL，则返回Replace-Expression。
• 如果Check-Expression不为空，则返回Check-Expression。

Replace-Expression的数据类型应该与Check-Expression的数据类型兼容。

请注意，ISNULL函数与NVL函数相同，后者是为了与Oracle兼容而提供的。

日期和时间显示转换

某些检查表达式数据类型需要从逻辑模式转换为ODBC模式或显示模式。例如日期和时间数据类型。如果替换表达式值不是相同的数据类型，则不能在ODBC模式或显示模式下转换此值，并生成SQLCODE错误：日期数据类型为-146；时间数据类型为-147

第六十五章 SQL函数 %INTERNAL

返回逻辑格式表达式的格式转换函数。

大纲

%INTERNAL(expression)

%INTERNAL expression

参数

• expression - 要转换的表达式。 字段名、包含字段名的表达式，或返回可转换数据类型(如DATE或%List)中的值的函数。

描述

%INTERNAL将表达式转换为逻辑格式，与当前选择模式(显示模式)无关。逻辑格式是数据的内存格式(对其执行操作的格式)。%INTERNAL通常用于选择列表SELECT-ITEM。

可以在WHERE子句中使用%INTERNAL，但强烈建议不要使用%INTERNAL，因为使用%INTERNAL会阻止在指定字段上使用索引，并且%INTERNAL会强制所有比较区分大小写，即使该字段有默认排序规则也是如此。

应用%INTERNAL会将列标题名称更改为诸如“Expression_1”之类的值；因此，通常需要指定列名别名，如下面的示例所示。

%INTERNAL将数据类型%DATE的值转换为整数数据类型值。%INTERNAL将数据类型%TIME的值转换为数字(15，9)数据类型值。之所以提供此转换，是因为ODBC或JDBC客户端不识别逻辑%DATE和%TIME值。

%INTERNAL是否转换日期取决于日期字段或函数返回的数据类型。

第六十四章 SQL函数 INSTR

返回子字符串在字符串中的位置的字符串函数，具有可选的搜索起始点和出现次数。

大纲

INSTR(string,substring[,start[,occurrence]])

参数

• string - 要在其中搜索子字符串的字符串表达式。 它可以是列的名称、字符串字面值或另一个标量函数的结果，其中基础数据类型可以表示为任何字符类型(如CHAR或VARCHAR2)。
• substring - 一个子字符串，被认为出现在字符串中。
• start - 可选-子字符串搜索的起始点，指定为正整数。 从字符串开始的字符计数，从1开始计数。 若要从字符串的开头开始搜索，请忽略此参数或指定从1开始。 起始值为0、空字符串、NULL或非数字值会导致INSTR返回0。 指定start为负数会导致INSTR返回。
• occurrence - 可选-一个非零整数，指定从起始位置搜索时返回哪个子字符串。 默认情况是返回第一个出现的位置。

INSTR返回INTEGER数据类型。

描述

INSTR在字符串中查找子字符串，并返回子字符串的第一个字符的位置。 位置以整数形式返回，从字符串的开头开始计算。 如果substring没有找到，则返回0(0)。 如果传递给任何一个参数一个NULL值，INSTR将返回NULL。

INSTR支持指定start作为子字符串搜索的起始点。

第六十三章 SQL函数 IFNULL

测试NULL并返回适当表达式的函数。

大纲

IFNULL(expression-1,expression-2 [,expression-3])

{fn IFNULL(expression-1,expression-2)}

参数

• expression-1 - 要计算以确定是否为NULL的表达式。
• expression-2 - 如果expression-1为NULL，则返回的表达式。
• expression-3 - 可选-如果expression-1不是NULL返回的表达式。 如果没有指定expression-3，则当expression-1不是NULL时返回NULL值。

返回的数据类型描述如下。

描述

支持IFNULL作为SQL通用函数和ODBC标量函数。 请注意，虽然这两个执行非常相似的操作，但它们在功能上是不同的。 SQL通用函数支持三个参数。 ODBC标量函数支持两个参数。 SQL通用函数和ODBC标量函数的双参数形式是不一样的; 当expression-1不为空时，它们返回不同的值。

SQL通用函数计算表达式1是否为NULL。 它永远不会返回expression-1:

• 如果expression-1为NULL，则返回expression-2。
• 如果expression-1不为NULL，则返回expression-3。

开发者们大家好!

你可能已经注意到了在IRIS 2021 Global的名字是随机的。

如果你用DDL来创建类而且想给Global一个确定的名字，实际上是可以做的。

在CREATE Table 里使用 WITH %CLASSPARAMETER DEFAULTGLOBAL='^GLobalName' ，如文档。参考以下例子:

第六十二章 SQL函数 HOUR

Time函数，它返回DateTime表达式的小时数。

大纲

{fn HOUR(time-expression)}

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

描述

Hour返回一个整数，指定给定时间或日期时间值的小时。小时是根据$HOROLOG或$ZTIMESTAMP值、ODBC格式的日期字符串或时间戳计算的。

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

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

请注意，可以提供时间整数(已用秒数)，但不能提供时间字符串(hh：mm：ss)。必须提供日期时间字符串(yyyy-mm-dd hh：mm：ss)。可以省略日期时间字符串的秒(：ss)或分钟和秒(mm：ss)部分，但仍返回小时部分。日期时间字符串的时间部分必须是有效的时间值。未验证日期时间字符串的日期部分。

小时以24小时表示。小时数(HH)部分应该是介于0到23之间的整数。输入上的前导零是可选的；输出上不显示前导零。

第六十一章 SQL函数 GREATEST

从一系列表达式中返回最大值的函数。

大纲

GREATEST(expression,expression[,...])

参数

• expression - 解析为数字或字符串的表达式。 对这些表达式的值进行比较。 表达式可以是字段名、文字、算术表达式、主机变量或对象引用。 最多可以列出140个逗号分隔的表达式。

描述

GREATEST返回逗号分隔的一系列表达式中的最大值。 表达式按从左到右的顺序求值。 如果只提供一个表达式，则GREATEST返回该值。 如果任何表达式为NULL，则GREATEST返回NULL。

如果所有表达式值都解析为规范数，则按数值顺序对它们进行比较。 如果引用的字符串包含规范格式的数字，则按数字顺序对其进行比较。 但是，如果引用的字符串包含非规范格式的数字(例如，'00'、'0.4'或'+4')，则将其作为字符串进行比较。 字符串比较按排序顺序逐字符执行。 任何字符串值都大于任何数字值。

空字符串大于任何数字值，但小于任何其他字符串值。

如果返回值是一个数字，则GREATEST将以规范格式返回它(删除前导和末尾的零，等等)。 如果返回值是一个字符串，则GREATEST将不改变返回值，包括任何前导或末尾空格。

GREATEST返回逗号分隔的一系列表达式中的最大值。 LEAST

第六十章 SQL函数 GETUTCDATE

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

大纲

GETUTCDATE([precision])

参数

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

描述

GETUTCDATE返回通用时间常数(UTC)日期和时间作为时间戳。由于UTC时间在地球上的任何地方都是相同的，不依赖于当地时区，也不受当地时差(如夏令时)的影响，因此当不同时区的用户访问同一数据库时，此函数对于应用一致的时间戳非常有用。

GETUTCDATE可以返回%TIMESTAMP数据类型格式(yyyy-mm-dd hh：mm：ss.ffff)或%PosiTime数据类型格式(编码的64位有符号整数)的时间戳。以下规则确定返回哪种时间戳格式：

1. 如果当前UTC时间戳被提供给数据类型为%PosiTime的字段，则此时间戳值将以POSIXTIME数据类型格式返回。例如，WHERE PosixField=GETUTCDATE() or INSERT INTO MyTable (PosixField) VALUES (GETUTCDATE())。
2. 如果当前UTC时间戳被提供给数据类型为%TIMESTAMP的字段，则此时间戳值以TIMESTAMP数据类型格式返回。其ODBC类型为TIMESTAMP，长度为16，精度为19

第五十九章 SQL函数 GETDATE

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

大纲

GETDATE([precision])

参数

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

描述

GETDATE将此时区的当前本地日期和时间作为时间戳返回；它根据本地时间变量(如夏令时)进行调整。

GETDATE可以返回%TIMESTAMP数据类型格式(yyyy-mm-dd hh：mm：ss.ffff)或%PosiTime数据类型格式(编码的64位有符号整数)的时间戳。以下规则确定返回哪种时间戳格式：

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

2. 如果当前时间戳被提供给数据类型为%TIMESTAMP的字段，则当前时间戳值将以TIMESTAMP数据类型格式返回。

第五十八章 SQL函数 FLOOR

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

大纲

FLOOR(numeric-expression)

{fn FLOOR(numeric-expression)}

参数

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

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

描述

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

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

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

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

示例

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

SELECT FLOOR(167.111) AS FloorNum1,
       FLOOR(167.456) AS FloorNum2,
       FLOOR(167.999) AS FloorNum3

167	167	167

SELECT {fn FLOOR(167.

在InterSystems IRIS和InterSystems Caché 里，是否您遇到过执行一个SQL Insert/Update语句，明明给的是正确的日期值，但被告知“值‘2022-01-01’ 校验失败”的类似情况，并感到困惑？

如果有，那么您需要了解一下InterSystems IRIS和InterSystems Caché保存和显示数据的模式。

一 数据模式

InterSystems IRIS和InterSystems Caché里，数据有3种模式，称之为SELECT MODE：
逻辑模式：这是数据被保存到InterSystems IRIS和InterSystems Cache'时的格式。例如，%Date类型的数据，在数据库里被保存为一个整数，即从1840年12月31号到这个日期的天数，而不是YYYY-MM-DD的格式。

ODBC模式：这是ODBC对数据定义的格式。在这个模式下，%Date类型的数据就会显示为YYYY-MM-DD的格式。

显示模式：这是数据在InterSystems IRIS和InterSystems Caché里默认的显示格式。例如在美国语言环境下，%Date的默认显示格式是DD/MM/YYYY格式。

InterSystems IRIS和InterSystems Caché只会使用逻辑模式保存数据，但可以以任何模式显示数据。

第五十七章 SQL函数 $FIND

字符串函数，返回字符串中子字符串的结束位置，可选的搜索起始点。

大纲

$FIND(string,substring[,start])

参数

• string - 要搜索的目标字符串。 它可以是变量名、数值、字符串字面值或任何有效表达式。
• substring - 要搜索的子字符串。 它可以是变量名、数值、字符串字面值或任何有效表达式。
• start - 可选-子字符串搜索的起始点，指定为正整数。 从字符串开始的字符计数，从1开始计数。 若要从字符串的开头开始搜索，请忽略此参数或指定从0或1开始。 负数、空字符串或非数字值将被视为0。 指定start为NULL会导致$FIND返回< NULL >。

$FIND返回SMALLINT数据类型。

描述

$FIND返回一个整数，指定子字符串在字符串中的结束位置。 $FIND搜索字符串的子字符串。 如果找到子字符串，$FIND返回子字符串后面第一个字符的整数位置。 如果substring未找到，$FIND返回0值。

可以包含start选项来指定搜索的起始位置。 如果start大于字符串中的字符数，$FIND返回一个值为0。 如果省略start，则默认为字符串位置1。 如果起始值为0、负数或非数字字符串，则位置1是默认值。

$FIND是区分大小写的。 使用其中一个大小写转换函数来定位字母或字符串的大写和小写实例。

第五十六章 SQL函数 $EXTRACT

按位置从字符串中提取字符的字符串函数。

大纲

$EXTRACT(string[,from[,to]])

参数

• string - 要从中提取子字符串的目标字符串。
• from - 可选-单个字符在目标字符串中的位置，或要提取的字符范围(包括)的开头。 指定为从1开始计数的正整数。
• to - 可选-要提取的字符范围的结束位置(包括)。 指定为从1开始计数的正整数。

描述

$EXTRACT返回字符串中指定位置的子字符串。 返回的子字符串的性质取决于所使用的参数。

• $EXTRACT(string)提取字符串中的第一个字符。
• $EXTRACT(string,from)从from指定的位置提取字符。 例如，如果变量var1包含字符串“ABCD”，下面的命令提取“B”(第二个字符):

SELECT $EXTRACT('ABCD',2) AS Extracted

2

• $EXTRACT(string,from,to)提取以from位置开始，以to位置结束的字符范围。 例如，下面的命令从字符串“1234Alabama567”中提取字符串“Alabama”(即从位置5到位置11的所有字符，包括在内):

SELECT $EXTRACT('1234Alabama567',5,11) AS Extracted

Alabama

这个函数返回VARCHAR类型的数据。

第五十五章 SQL函数 %EXTERNAL

以显示格式返回表达式的格式转换函数。

大纲

%EXTERNAL(expression)

%EXTERNAL expression

参数

• expression - 要转换的表达式。字段名、包含字段名的表达式或返回值为可转换数据类型(如DATE或%LIST)的函数。不能是流字段。

描述

%EXTERNAL将表达式转换为显示格式，与当前选择模式(显示模式)无关。显示格式表示VARCHAR数据类型的数据，无论字段或数据类型LogicalToDisplay方法执行什么数据转换。

%EXTERNAL通常用于选择列表SELECT-ITEM。它可以在WHERE子句中使用，但不建议这样使用，因为使用%EXTERNAL会阻止在指定字段上使用索引。

应用%EXTERNAL会将列标题名称更改为诸如“Expression_1”之类的值；因此，通常需要指定列名别名，如以下示例所示。

%EXTERNAL是否转换日期取决于日期字段或函数返回的数据类型。%EXTERNAL转换CURDATE、CURRENT_DATE、CURTIME和CURRENT_TIME值。它不转换CURRENT_TIMESTAMP、GETDATE、GETUTCDATE、NOW和$HOROLOG值。

当%EXTERNAL将%List结构转换为显示格式时，显示的列表元素似乎由空格分隔。

第五十四章 SQL函数 EXP

返回数字的指数(自然对数的倒数)的标量数值函数。

大纲

{fn EXP(expression)}

参数

• expression - 对数指数，数值表达式。

EXP返回NUMERIC或DOUBLE数据类型。如果表达式的数据类型为DOUBLE，则EXP返回DOUBLE；否则返回NUMERIC。

描述

Exp是指数函数e n，其中e是常数2.718281828。因此，要返回e的值，可以指定{fn exp(1)}。Exp是自然对数函数log的逆函数。

EXP返回一个精度为36、小数位数为18的值。如果传递的值为NULL，则EXP返回NULL。

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

示例

下面的示例返回常量e：

SELECT {fn EXP(1)} AS e_constant

2.718281828459045235

下面的嵌入式SQL示例返回整数0到10的指数值：

ClassMethod Exp()
{
	s a = 0
	while a < 11 {
	&sql(SELECT {fn EXP(:a)} INTO :b)
	if SQLCODE'=0 {
		w !,"错误代码 ",SQLCODE
		q 
	} else {
		w !,"指数 ",a," = ",b
		s a=a+1 }
	}
}

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