第四十八章 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

第四十七章 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兼容。

Datepart 参数

第四十四章 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 参数

[toc]

第四十三章 SQL函数 DATEDIFF

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

大纲

DATEDIFF(datepart,startdate,enddate)

参数

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

描述

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

第四十二章 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指定一个负整数来减少日期部分。

第四十一章 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。

这个函数也可以从ObjectScript中使用DATE()方法调用来调用:

第四十章 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函数 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位带符号整数)的时间戳。 以下规则决定返回哪种时间戳格式:

第三十六章 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数据类型返回。

第三十五章 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数据类型返回。

第三十四章 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数据类型返回当前日期和时间。

第三十三章 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运算符显示两次连接：

第二十九章 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函数是相同的。 它们都接受一个流字段参数。 LENGTH和$LENGTH函数不接受流字段参数。

第二十七章 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。

第二十五章 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.999) AS CeilingNum3

第二十三章 SQL函数 CAST（二）

转换位值

可以将expr值转换为BIT以返回0或1。 如果expr为1或任何其他非零数值，则返回1。 如果expr为“TRUE”、“TRUE”或“TRUE”，则返回1。 (“True”可以用任何大小写组合表示，但不能缩写为“T”。) 如果expr是任何其他非数值值，则返回0。 如果expr为0，则返回0。

在下面的例子中，前5个CAST操作返回1，后5个CAST操作返回0:

SELECT CAST(1 AS BIT) AS One, 
       CAST(7 AS BIT) AS Num,      
       CAST(743.6 AS BIT) AS Frac,  
       CAST(0.3 AS BIT) AS Zerofrac,
       CAST('tRuE' AS BIT) AS TrueWord,
       CAST(0 AS BIT) AS Zero,  
       CAST('FALSE' AS BIT) AS FalseWord, 
       CAST('T' AS BIT) AS T,    
       CAST('F' AS BIT) AS F,   
       CAST(0.0 AS BIT) AS Zerodot     

示例

第二十二章 SQL函数 CAST（一）

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

大纲

第二十一章 SQL函数 ATAN2

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

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

大纲

{fn ATAN2(y,x)}

参数

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

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

描述

ATAN2采用射线(y,x)的笛卡尔坐标，并以浮点数的形式返回角的正切反(弧)。 用两个坐标的符号来确定笛卡尔坐标。 当x为正值时，ATAN2返回与ATAN(y/x)相同的值。 如果传递一个NULL值，ATAN2将返回NULL。 ATAN2将非数字字符串(包括空字符串("))视为数字值0。

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

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

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

示例

下面的例子调用ATAN2:

SELECT {fn ATAN2(15,30)} AS ArcTangent 

0.463647609000806116

第二十章 SQL函数 ATAN

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

大纲

{fn ATAN(numeric-expression)}

参数

• numeric-expression - 一个数值表达式。 这是这个角的正切。

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

描述

ATAN接受任何数值，并以浮点数返回角度正切的反(弧)值。 如果传递一个NULL值，ATAN将返回NULL。 ATAN将非数字字符串(包括空字符串("))视为数字值0。

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

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

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

示例

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

SELECT {fn ATAN(0.52)} AS ArcTangent 

0.479519291992596165

第十九章 SQL函数 ASIN

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

大纲

{fn ASIN(numeric-expression)}

参数

• numeric-expression - 数值在-1到1之间的数值表达式。 这是这个角的正弦值。

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

描述

ASIN以浮点数的形式返回角度正弦的反(弧)值。 numeric-expression的值必须是有符号的十进制数，取值范围为1 ~ -1(含1)。 超出此范围的数字将导致运行时错误，生成SQLCODE -400(发生致命错误)。 如果传递一个NULL值，ASIN将返回NULL。 ASIN将非数字字符串(包括空字符串("))视为数字值0。

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

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

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

示例

下面的例子展示了ASIN对两个正弦的影响。

SELECT {fn ASIN(0.52)} AS ArcSine 

0.54685095069594411

SELECT {fn ASIN(-1.00)} AS ArcSine 

-1.570796326794896619

第十八章 SQL函数 ASCII

一个字符串函数，返回字符串表达式的第一个(最左边)字符的整型ASCII码值。

大纲

ASCII(string-expression)

{fn ASCII(string-expression)}

参数

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

描述

如果传入一个NULL或空字符串值，ASCII将返回NULL。 空字符串返回NULL与SQL Server一致。

SELECT ASCII('Z') AS AsciiCode

90

SELECT {fn ASCII('ZEBRA')} AS AsciiCode 

90

在执行ASCII转换之前，SQL将数字转换为规范形式。 下面的例子返回55，它是数字7的ASCII值:

SELECT ASCII(+007) AS AsciiCode

55

如果数字以字符串的形式表示，则不执行此数字解析。 下面的例子返回43，它是加(+)字符的ASCII值:

SELECT ASCII('+007') AS AsciiCode 

43