通用规则和常见表达式

地理数据库数据源在日期时间字段中存储日期。 但是，shapefile 并非如此。 因此，下面所列的大部分查询语法都包含对时间的引用。 在某些情况下，当已知字段只包含日期时，查询中的时间部分可以安全地省略掉；而在其他情况下则需要声明，否则查询将返回语法错误。

要搜索日期字段，需要注意日期时间字段的类型以及数据源所需的语法。 如果在查询构建器的“子句”模式下构建日期查询，将自动为用户生成正确的语法。 下面是一个查询示例，它将返回文件地理数据库数据源的日期时间字段中 2011 年 1 月 1 日或之后的所有记录。

INCIDENT_DATE >= timestamp '2011-01-01 00:00:00'

当非空时间带日期存储时（例如 1999 年 1 月 12 日 04:00:00），查询仅日期时不会返回记录。 如果将仅日期传递至日期时间字段，则会在时间中填充零，并仅检索时间为上午 12:00:00 的记录。

属性表内会以用户友好的格式来显示日期和时间（取决于用户的区域设置）而不是采用基础数据库的格式。 这可能存在一些缺点：

• SQL 查询中显示的字符串可能会与表中显示的值稍有不同，尤其是当包含时间时。 例如，输入的时间 00:00:15 将在属性表中（当您的区域设置为美国时）显示为 12:00:15 a.m.，对应于查询语法将是 Datefield = '1899-12-30 00:00:15'。
• 属性表在您保存编辑之前无法知道是何种基础数据源。 它首先会尝试将输入的值格式化为符合自己的格式，然后在保存编辑内容时，会再尝试对生成的值进行调整以便存入数据库。 因此，您可以在 shapefile 中输入一个时间值，但您会发现当您保存编辑内容时该值会被丢弃。 随后该字段将包含值“1899-12-30”并显示 12:00:00 a.m. 或其他等效的值（取决于您的区域设置）。

地理数据库的日期时间语法

下面是文件地理数据库、移动地理数据库和 shapefile 中的日期支持的日期时间 SQL 语法的示例。 一些企业级地理数据库和 RDBMS 数据源还支持日期时间 SQL 语法，尽管这些数据源可能需要稍微不同的 SQL 语法。

有关支持的特定 SQL 表达式语法和数据类型，请查阅适用于您的数据库管理系统的文档。

Datefield = timestamp 'yyyy-mm-dd'

Datefield = timestamp 'yyyy-mm-dd hh:mm:ss'

//DateOnlyField = time 'yyyy-mm-dd'
DateOnlyField = time '2003-01-08'
//TimeOnlyField = date 'HH24:mm:ss'
TimeOnlyField = date '14:35:00'
//TimestampOffsetField = timestamp 'yyyy-mm-dd HH24:mm:ss -TZH:TZM' 
TimestampOffsetField = timestamp '2003-01-08 14:35:00 -08:00'

Datefield = JULIANDAY('yyyy-mm-dd')

Datefield = JULIANDAY('yyyy-mm-dd HH24:mm:ss')

//TimestampOffsetField = 'yyyy-mm-dd HH24:mm:ss -TZH:TZM'
TimestampOffsetField = '2003-01-08 14:35:00 -08:00'
//DateOnlyField = JULIANDAY('yyyy-mm-dd')
DateOnlyField = JULIANDAY('2003-01-08')
//TimeOnlyField = 'HH24:mm:ss'
TimeOnlyField = '14:35:00'

Datefield = date 'yyyy-mm-dd'

已知局限性

对连接的左侧部分（第一张表）的日期查询只适用于基于文件的数据源，如文件地理数据库、shapefile 和 DBF 表。 不过，对于非基于文件的数据（如企业级地理数据库数据）也有解决方法，如下文所述。

当使用为基于文件的数据源所开发的受限的 SQL 版本时，对连接的左侧部分的日期查询将获得成功。 如果您没有使用此类数据源，可以强制表达式使用这种格式。 您可以通过确保查询表达式涉及一个以上连接表的字段来实现此操作。 例如，如果要素类和表（FC1 和 Table1）进行连接且均来自于企业级地理数据库，则下列表达式将失败或不返回任何数据：

FC1.date = date #01/12/2001#
FC1.date = date '01/12/2001'

要想查询成功，您可以创建如下查询：

FC1.date = date '01/12/2001' and Table1.OBJECTID > 0

由于此查询涉及到两个表的字段，因此将使用受限的 SQL 版本。 在此表达式中，连接创建期间匹配记录的 Table1.OBJECTID 始终为 > 0，因此对于包含连接匹配项的所有行来说此表达式均为 true。

要确保选择 FC1.date = date '01/12/2001' 的每条记录，可使用下列查询：

FC1.date = date '01/12/2001' and (Table1.OBJECTID IS NOT NULL OR Table1.OBJECTID IS NULL)

此查询将选择 FC1.date = date '01/12/2001' 的所有记录，而无论每条记录是否是连接匹配项。

算术运算符

算术运算符用于对数值进行加、减、乘、除的运算。

算术运算符

运算符	描述
*	乘法算术运算符
/	除法算术运算符
+	加法算术运算符
-	减法算术运算符

比较运算符

使用比较运算符可以将两个表达式进行比较。

比较运算符

运算符	描述
<	小于。 适用于字符串（基于字母顺序进行比较）、数值和日期。
<=	小于或等于。 适用于字符串（基于字母顺序进行比较）、数值和日期。
<>	不等于。 适用于字符串（基于字母顺序进行比较）、数值和日期。
>	大于。 适用于字符串（基于字母顺序进行比较）、数值和日期。
>=	大于或等于。 适用于字符串（基于字母顺序进行比较）、数值和日期。
IS [NOT] NULL	选择指定字段为空值的记录。 如果 NULL 前置 NOT ，则将选择指定字段中包含任意值的记录。

逻辑运算符

与比较运算符类似，逻辑运算符会测试语句的真实性并返回适用于给定语句的值。

逻辑运算符

运算符	描述
AND	结合两个条件，如果两个条件都为 true 则选择记录。 例如，以下表达式将选择面积大于 1,500 平方英尺且有一个能容纳 2 台以上汽车的车库的所有房屋： AREA > 1500 AND GARAGE > 2
[NOT] BETWEEN x AND y	选择值大于等于 x 且小于等于 y 的记录。 如果前置 NOT ，则将选择值在指定范围之外的记录。 例如，以下表达式将选择值大于等于 1 且小于等于 10 的所有记录： OBJECTID BETWEEN 1 AND 10 这与以下表达式等效： OBJECTID >= 1 AND OBJECTID <= 10 但是，在查询具有索引的字段时使用包含 BETWEEN 的表达式效率会更高。
[NOT] EXISTS	如果子查询返回至少一条记录则返回 TRUE；否则返回 FALSE。 例如，如果 OBJECTID 字段包含一个值 50，则以下查询将返回 TRUE： EXISTS (SELECT * FROM parcels WHERE OBJECTID = 50) 只有文件地理数据库和企业级地理数据库支持 EXISTS 运算符。
[NOT] IN	如果记录的某个字段包含多个字符串或值的其中一个，那么选择这条记录。 当前置 NOT 时，如果记录的某个字段不包含多个字符串或值的任何一个，那么将选择这条记录。 例如，以下表达式将搜索四个州名称： STATE_NAME IN ('Alabama', 'Alaska', 'California', 'Florida')
x [NOT] LIKE y [ESCAPE '转义字符']	将 LIKE 运算符（不是 = 运算符）与通配符结合使用可以构建对部分字符串的搜索。 百分号 (%) 表示这个位置可以是任意字符，即 1 个字符、100 个字符或者无字符均可。 此外，要在查询时通配符仅代表一个字符，可使用下划线 (_)。 如果需要访问非字符数据，请使用 CAST 函数。 例如，以下查询将返回整数字段 SCORE_INT 中以 8 开头的数值： CAST (SCORE_INT AS VARCHAR(10)) LIKE '8%' 要在搜索字符串中包含百分号或下划线，请使用 ESCAPE 关键字来将另一种字符指定为转义字符，该字符表示紧接其后的是真正的百分号或下划线。 例如，以下表达式将返回任何包含 10% 的任何字符串，例如 10% DISCOUNT 或 A10%： AMOUNT LIKE '%10$%%' ESCAPE '$'
NOT	选择与表达式不匹配的记录。 例如，以下表达式将选择除 California 之外的所有州： NOT STATE_NAME = 'California'
OR	结合两个条件，如果两个条件中至少有一个为 true 则选择记录。 例如，以下表达式将选择面积大于 1,500 平方英尺或有一个能容纳 2 台以上汽车的车库的所有房屋： AREA > 1500 OR GARAGE > 2

字符串运算符

运算符	描述
||	返回连接两个或多个字符串表达式后得到的字符串。 FIRST_NAME || MIDDLE_NAME || LAST_NAME

日期函数

所有日期函数都将返回一个日期值。

字符串函数

以 string_exp 表示的参数可以是列名、字符串文本或者另一个标量函数的结果，其基础数据类型可表示为字符型。

以 character_exp 表示的参数是长度可变的字符型字符串。

以 start 或 length 表示的参数可以是数值文本或者另一个标量函数的结果，其基础数据类型可表示为数值型。

这些字符串函数以 1 为基础；即字符串的第一个字符为字符 1。

字符串函数

函数	描述
CHAR_LENGTH (string_exp)	返回字符串表达式的字符长度。
LOWER (string_exp)	返回一个与 string_exp 相等的字符串，其中所有大写字符均会转换为小写字符。
POSITION (character_exp IN character_exp)	返回第一个字符表达式在第二个字符表达式中的位置。 结果是一个确切的数值，采用预先定义的精度且小数位数为零。
SUBSTRING (string_exp FROM start FOR length)	返回一个从 string_exp 派生的字符串，其起始字符位置由 start 指定，字符数由 length 指定。
TRIM ( BOTH | LEADING | TRAILING trim_character FROM string_exp)	返回字符串的开头、末尾或两端移除 trim_character 后所得的 string_exp 。
UPPER (string_exp)	返回一个与 string_exp 相等的字符串，其中所有小写字符均会转换为大写字符。

数值函数

所有数值函数均返回数值型值。

以 numeric_exp 、 float_exp 或 integer_exp 表示的参数可以是列名、另一个标量函数的结果或数值文本，其基础数据类型可表示为数值型。

数值函数

函数	描述
ABS (numeric_exp)	返回 numeric_exp 的绝对值。
ACOS (float_exp)	以角度形式返回 float_exp 的反余弦值，用弧度表示。
ASIN (float_exp)	以角度形式返回 float_exp 的反正弦值，用弧度表示。
ATAN (float_exp)	返回作为角度的 float_exp 的反正切值，用弧度表示。
CEILING (numeric_exp)	返回大于或等于 numeric_exp 的最小整数。
COS (float_exp)	返回 float_exp 的余弦值，其中 float_exp 是以弧度表示的角度。
FLOOR (numeric_exp)	返回小于或等于 numeric_exp 的最大整数。
LOG (float_exp)	返回 float_exp 的自然对数。
LOG10 (float_exp)	返回 float_exp 的以 10 为底的对数。
MOD (integer_exp1, integer_exp2)	返回 integer_exp1 除以 integer_exp2 的商。
POWER (numeric_exp, integer_exp)	返回 numeric_exp 的 integer_exp 次幂的值。
ROUND (numeric_exp, integer_exp)	返回四舍五入至小数点右侧第 integer_exp 位的 numeric_exp 。 如果 integer_exp 为负数，则 numeric_exp 将被四舍五入至小数点左侧第 | integer_exp | 位。
SIGN (numeric_exp)	返回 numeric_exp 正负号的标志。 如果 numeric_exp 小于零，则返回 -1。 如果 numeric_exp 等于零，则返回 0。 如果 numeric_exp 大于零，则返回 1。
SIN (float_exp)	返回 float_exp 的正弦值，其中 float_exp 是以弧度表示的角度。
TAN (float_exp)	返回 float_exp 的正切值，其中 float_exp 是以弧度表示的角度。
TRUNCATE (numeric_exp, integer_exp)	返回截断至小数点右侧第 integer_exp 位的 numeric_exp 。 如果 integer_exp 为负数，则 numeric_exp 将被截断至小数点左侧第 | integer_exp | 位。

CAST 函数

CAST() 函数将值或表达式从一种数据类型转换为另一种指定的数据类型。 语法如下：

CAST (expression AS data_type(length))

• 其中 expression 是必填参数，可以是文本值或将要转换的任何类型（例如，列名、变量）的有效表达式。
• 其中 data_type 是必填参数，使用的关键字是表达式将转换为的结果数据类型。 有关用于有效数据类型的关键字列表，请参阅下 表 。
• 其中 length 是可选参数，用于指定结果数据类型的长度。

例如，在某些方案中，可能需要字符串操作，但是如果数据存储在数值类型字段中，则查询将无法工作。 但是，可使用 CAST() 函数将数值字段转换为用于 SQL 操作的字符串。 此代码将数值字段 SQLNUM 强制转换为文本字段，然后可将其用于文本操作中。

CAST(SQLNUM AS CHARACTER(12))

下表包含用于数据类型转换的关键字，可以将其指定为大写或小写形式。

使用 CAST 函数时支持的数据类型转换

数据类型	关键字
长整型	INTEGER INT
短整型	SMALLINT
浮点型（单精度浮点型）	REAL FLOAT [p] 默认值为 7，与 REAL 等效。p > 7 等效于双精度
双精度（双精度浮点型）	DOUBLE PRECISION NUMERIC (p[,s]) DECIMAL (p[,s])
字符串	CHAR(n) VARCHAR(n) CHARACTER(n)
日期时间	DATE TIME TIMESTAMP
注： p - 精度 s - 比例 n - 定义字符串的长度（以字符为单位） ( ) - 必需参数 [ ] - 可选参数

CAST 函数示例

• 示例 1：

  CAST(AREA AS INTEGER)

  将 Float 数据类型的 AREA 转换为 INTEGER 会返回一个整数，并截断小数点后的任何结果值。

• 示例 2：

  CAST(Rent AS FLOAT) + Utilities > 2000.45

  将 CHARACTER 数据类型的 Rent 转换为 FLOAT 数据类型，其中 Utilities 也是 FLOAT 数据类型。

EsriCast

SQLite CAST 运算符用于处理原生数据类型；但是，随着新字段类型以及其他更多非原生数据类型的发布，您必须调整运算符，以使 SQLite 可以正确运行。 EsriCast 的开发是为了使移动地理数据库中必要的 SQLite 运算符能够访问和理解 ArcGIS Pro 可处理的多种数据类型。

示例语法： EsriCast(expression, source_data_type, target_data_type)

EsriCast 数据关键字

EsriCast 数据转换示例