第八十二章 SQL函数 $LISTDATA

列表函数，指示指定元素是否存在并具有数据值。

大纲

$LISTDATA(list[,position])

参数

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

描述

$LISTDATA 检查列表中请求元素中的数据。如果位置参数指示的元素在列表中并且具有数据值，则 $LISTDATA 返回值 1。如果元素不在列表中或没有数据值，则 $LISTDATA 返回值 0。

第161章 SQL函数 YEAR

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

大纲

YEAR(date-expression)

{fn YEAR(date-expression)}

参数

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

描述

YEAR 将日期整数（$HOROLOG 日期）、ODBC 格式日期字符串或时间戳作为输入。 YEAR 以整数形式返回相应的年份。

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

第七十五章 SQL函数 LEFT

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

大纲

{fn LEFT(string-expression,count)}

参数

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

描述

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

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

第146章 SQL函数 TO_POSIXTIME

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

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

第九十一章 SQL函数 LOWER

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

大纲

LOWER(string-expression)

参数

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

描述

LOWER 函数将大写字母转换为小写字母以供显示。这是 UPPER 函数的逆函数。 LOWER 对非字母字符没有影响。它保留不变的标点符号、数字以及前导和尾随空格。

LOWER 不强制将数字解释为字符串。 SQL 将数字转换为规范形式，删除前导零和尾随零。指定为字符串的数字不会转换为规范形式，并保留前导零和尾随零。

LCASE 函数也可用于将大写字母转换为小写字母。

第三十六章 SQL函数 CURRENT_TIME

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

大纲

CURRENT_TIME
CURRENT_TIME(precision)

参数

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

CURRENT_TIME返回时间数据类型。

描述

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

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

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

第四十章 SQL命令 DROP USER

删除用户帐户。

大纲

DROP USER user-name

参数

• user-name 要删除的用户名。

描述

DROP USER命令可删除用户帐户。此用户帐户是使用CREATE USER创建的，并指定了用户名。如果指定的用户名与现有用户帐户不对应， IRIS将发出SQLCODE-118错误。可以通过调用$SYSTEM.SQL.Security.UserExists()方法来确定用户是否存在。

用户名不区分大小写。

还可以使用管理门户删除用户。选择System Administration(系统管理)、Security(安全性)、Users(用户)以列出现有用户。在此用户帐户表上，可以单击要删除的用户帐户的删除。

第125章 SQL函数 SIGN

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

大纲

SIGN(numeric-expression)

{fn SIGN(numeric-expression)}

参数

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

SIGN 返回 SMALLINT 数据类型。

第七十七章 SQL函数 LENGTH

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

大纲

LENGTH(string-expression)

{fn LENGTH(string-expression)}

参数

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

LENGTH 返回 INTEGER 数据类型。

描述

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

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

第二十一章 SQL函数 ATAN2

接受两个坐标并返回以弧度为单位的反正切角的标量数值函数。

注意：IRIS可用，IRIS以下不可用。

大纲

{fn ATAN2(y,x)}

参数

• y - 指定y轴坐标的数值表达式。
• x - 指定x轴坐标的数值表达式。

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

第十八章 SQL谓词 SOME

将值与子查询中的至少一个匹配值匹配。

第九十五章 SQL函数 MINUTE

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

大纲

{fn MINUTE(time-expression)}

参数

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

描述

MINUTE 返回一个整数，指定给定时间或日期时间值的分钟数。为 $HOROLOG 或 $ZTIMESTAMP 值、ODBC 格式日期字符串或时间戳计算分钟。

第八十五章 SQL函数 $LISTGET

返回列表中的元素或指定默认值的列表函数。

大纲

$LISTGET(list[,position[,default]])

参数

• list - 计算结果为有效列表的表达式。列表是包含一个或多个元素的编码字符串。可以使用 SQL 或 ObjectScript 的 $LISTBUILD 或 $LISTFROMSTRING 函数创建列表。可以使用 SQL 或 ObjectScript $LIST 函数从现有列表中提取列表。
• position - 可选 — 解释为指定列表中的位置的表达式。
• default - 可选 — 如果列表元素具有未定义的值，则该表达式提供要返回的值。

描述

$LISTGET 将指定列表中的请求元素作为标准字符串返回。如果位置参数的值引用不存在的成员或标识具有未定义值的元素，则返回指定的默认值。

第三十四章 SQL函数 CURDATE

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

大纲

{fn CURDATE()}
{fn CURDATE}

描述

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

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