Arcade 示例

计算两个数值字段 Sales2016 和 Sales2017 的值的差值，以填充数值字段。

$feature.Sales2016 - $feature.Sales2017

SQL 示例

使用数值字段 (SalesDifference) 的计算功能以了解数值字段 Sales2016 和 Sales2017 之间的差值。

Sales2016 - Sales2017

使用小数来填充数值字段，该小数是计算 18 岁以下人口比重的结果。

PopUnder18/TotalPop

Arcade 示例

Concatenate($feature.room,$feature.floor)

SQL 示例

CONCAT(Floor,Room)

Arcade 示例

Trim('New Hampshire ')

SQL 示例

Trim(TRAILING ' ' FROM 'New Hampshire ')

Arcade 示例

以下示例根据图层中另一字段中的数字 (HowMany)，在不同条件下将不同的字符串值（None、Low、High 或 Other）写入文本字段。

When(
  $feature.HowMany == 0, "None",
  $feature.HowMany == 1, "Low",
  $feature.HowMany == 2,  "High",
"Other")

在 Map Viewer 经典版 中使用过滤器

如果您不想使用 Arcade 表达式，则可以对地图中的图层应用过滤器、计算已过滤要素的值、移除该过滤器、根据不同的值应用另一个过滤器以及计算这些字段的值。 下面的步骤对此过程进行了描述。

例如，如果您拥有一个数值字段，该字段使用代码（3、2 和 1）来记录商店类型，并且您希望使用一个字符串字段来拼写出这些代码所表示的内容（连锁店、专营店和独立门店），则可以向图层添加一个字符串字段，将图层添加到地图，对每个代码值进行过滤，然后计算字符串字段的值。

Arcade 示例

本示例将使用 Replace 函数将英式拼写（彩色）更改为美式拼写。

Replace($feature.color, 'colour', 'color')

在 Map Viewer 经典版 中使用过滤器

与根据另一字段中的值填充字段的方式类似，您可以对地图中的图层应用过滤器，以仅返回包含要替换的字段值的要素。 接下来，设置过滤字段等于新值以更新字段值。

例如，如果需要更正输错的值或将单词转换为缩写，则可以过滤需要更改的文本字符串，然后设置字段等于新值。

Arcade 示例

本示例通过将总人口值 (TotalPop) 除以面要素的面积（以平方英里为单位）来确定每个要素的人口密度：

$feature.TotalPop / Area ($feature,
'square-miles')

Arcade 示例

本示例使用 Geometry 函数来计算点图层中每个点的 x 坐标字段。

Geometry($feature).x

Arcade 示例

本示例使用 DateAdd 函数将日期增加七天，以获得以下周的日期。

var startDate = Date($feature.dateField);
var oneWeekLater = DateAdd(startDate, 7, 'days');
return oneWeekLater;

SQL 示例

使用间隔查询增加或减去日期字段中的时间，如以下计算所示。 第一个示例在日期中增加三天，以生成新日期。 第二个示例从时间戳字段中减去三天。

<DateField> + INTERVAL '3'DAY = updated date

<DateField> - INTERVAL '3 00:00:60' DAY TO SECOND = updated date

可以使用以下日期和时间值的间隔：

• 天
• 小时
• 分钟
• 秒
• 天到小时
• 天到分钟
• 天到秒
• 小时到分钟
• 小时到秒
• 分钟到秒

Arcade 示例

以下示例使用 DateDiff 函数，以通过求出当前日期 ( endDate ) 与某人的出生日期 ( startDate ) 的差值来计算其年龄：

var startDate = Date($feature.startDateField);
var endDate = Date($feature.endDateField);
var age = DateDiff(endDate, startDate, 'years');
return age;

SQL 示例

可使用任意日期字段和日期文本的组合来计算两个日期间的时间长度。 下面的第一种计算使用日期字段，而第二种计算使用日期文本。 第三种和第四种计算同时使用日期字段和日期文本。

<DateField1> - <DateField2> = number of days in between

DATE'<SQL-supported Date Literal>' - DATE'< SQL-supported Date Literal>' = number of days in between

<DateField1> - DATE'<SQL-supported Date Literal>' = number of days in between

DATE'<SQL-supported Date Literal>' - <DateField2>  = number of days in between

其结果为从一个日期字段或文本中减去另一个日期字段或文本计算得出的数字字段。 该数字结果（以天为单位）既可以是整数也可以包含小数 - 例如，1.5 表示一天半或 36 小时。

在上文中的电表检查示例中，可使用以下任一种计算来计算安装日期 6/1/2015 与检查日期 10/1/2015 之间的时间长度。 第一种计算使用日期字段，第二种计算使用日期文本，第三种和第四种计算同时使用日期字段和日期文本。

<InspectionDateField> - <InstallationDateField> = 122 (days)

DATE'10/1/2015' - DATE'6/1/2015' = 122 (days)

<InspectionDateField> - DATE'6/1/2015' = 122 (days)

DATE'10/1/2015' - <InstallationDateField> = 122 (days)

日期函数

可根据日期字段进行一系列计算。 例如，您可以增加或减去日期字段中的时间，或计算两个日期字段间的差值。

在使用日期字段之前，请阅读以下 重要的注意事项 。

计算日期字段时可以使用任意日期和数字字段以及文本的组合。 使用日期文本时，必须使用支持 SQL 的日期格式。

可用的日期函数如下：

功能	描述
CURRENT_DATE	以 UTC 时间返回当前日期。 客户端中显示的内容取决于您正在使用的客户端。 在门户网站中，将以浏览器的时区来显示日期。 以下示例将返回 inspection_date 字段中日期晚于今天的日期的所有值： inspection_date > CURRENT_DATE
CURRENT_TIMESTAMP	返回当前 UTC 日期和时间（小时、分钟、秒）。 客户端中显示的内容取决于您正在使用的客户端。 在门户网站中，将以浏览器的本地时间来显示时间。 在本示例中，将针对 appointments 字段返回所有早于今天的日期和当前时间（UTC 格式）的时间戳值。 appointments < CURRENT_TIMESTAMP
EXTRACT(<unit> FROM '<date>')	返回指定 <date> 的单个部分 ( <unit> )。 可能的 <unit> 值包括但不限于年、月、日、小时和分钟。 示例包括以下内容： EXTRACT(MONTH FROM '12-21-2016') - 返回 12。 EXTRACT(DAY FROM '12-21-2016 12:00') - 返回 21。 EXTRACT(HOUR FROM '12-21-2016 15:00:44') - 返回 15。

数值函数

功能	描述
ABS(<number>)	返回所指定数值的绝对（正）值。
CEILING(<number>)	返回大于或等于指定数值的最小整数。 示例 CEILING(12.93) - 结果为 13。
COS(<number>)	返回 <number> （假设其为以弧度为单位的角）的三角余弦值。
CAST(<number> AS FLOAT | INT)	将 number 转换为其他类型。 FLOAT 可将指定数值转换为双精度型，而 INT 可将其转换为整型。
FLOOR(<number>)	返回小于或等于指定数值的最大整数。 示例 FLOOR(12.93) - 结果为 12。
LN(<number>,<decimal_place>)	指定数值的自然对数。
LOG(<number>,<decimal_place>)	指定数值以 10 为底的对数。
MOD(<number>, <n>)	返回被除数 (<number>) 除以除数 <n> 后的余数。 <n> 和 <number> 必须均为整型。 示例包括以下内容： MOD(10, 4) - 结果为 2。 MOD(CAST(DBLFIELD AS INT), 4) - DBLFIELD 是双精度型字段，所以需使用 CAST 函数将值从双精度型转换为整型。
NULLIF(<number>, <value>)	若指定数值等于指定值，则返回 null 。 NULLIF 通常用于防止出现因将 <value> 设置为 0 而产生的除数为零的错误。 只要计算中任意参数出现 null 字段值，计算结果即为 null 。 例如，假设您需要将一个双精度字段的值换算成 TOTALPOP 除以 POP18 。 如果任意要素的 POP18 值等于零，则计算将导致一个除数为零的错误。 您可以创建一个 过滤器 来隐藏 POP18 为零的那些记录，然后执行计算。 也可以使用快捷方式 NULLIF 。 TOTALPOP / NULLIF(POP18, 0) - 如果 POP18 等于 0，则返回 null ；否则，返回 TOTALPOP / POP18 的值。
POWER(<number> , <y>)	返回指定数值的指定幂的值 ( <y> )。
ROUND(<number> , <length>)	将所指定数值四舍五入至指定长度。 如果 <length> 使用正数，则数值将舍入到由 <length> 指定的小数位。 如果 <length> 为负数，则指定的 <number> 将舍入到小数点左侧的相应位置。 示例 ROUND(10.9934,2) - 返回 10.99。 ROUND(10.9964,2) - 返回 11.00。 ROUND(111.0,-2) - 返回 100.00。
SIN(<number>)	返回指定 <number> （假设其为以弧度为单位的角）的三角正弦值。
TAN(<number>)	返回指定 <number> （假设其为以弧度为单位的角）的正切值。
TRUNC(<number>,<decimal_place>)	在指定 <decimal_place> 处截断 <number> 。 正的 <decimal_place> 将截断至指定的小数位。 若 <decimal_place> 为负数，将在小数点左侧的相应位置截断 <number> 。 示例 TRUNC(111.996,2) - 返回 111.99。 TRUNC(111.996,-2) - 返回 100.00。

字符串函数

功能	描述
CHAR_LENGTH(<string>)	返回指定字符串的字符数。 结果为整数。 示例 CHAR_LENGTH('Redlands') - 结果为 8。
CONCAT(<string1>, <string2>)	连接两个字符串值。 只能提供两个字符串。 要连接两个以上的字符串，需嵌套连续的 CONCAT 函数，如下所示。 示例 CONCAT('A', 'B') - 结果为 'AB' 。 CONCAT('A', CONCAT(':', 'B')) - 结果为 'A:B' 。 空值会转换成空字符串。
POSITION(<substring> in <string>)	返回所指定字符串中指定子字符串第一次出现时的位置。 如果没有找到指定的子字符串，则结果为 0。 示例 POSITION('boat'in 'Sailboat') - 结果为 5。 POSITION('motor'in 'Sailboat') - 结果为 0。
SUBSTRING(<string>, <start>, <length>)	返回部分字符串值； <start> 是一个整数索引，用于指定所返回字符的起始位置， <length> 则为返回的字符数。 示例 SUBSTRING('Sailboat', 5, 4) - 结果为 'boat' 。 SUBSTRING('Sailboat', 1, 4) - 结果为 'Sail' 。 SUBSTRING('Sailboat', 5, 100) - 结果为 'boat' 。
TRIM(BOTH | LEADING | TRAILING ' ' FROM <string>)	返回从所指定字符串中移除所有前导或尾随空格后的字符串。 示例 TRIM(BOTH ' ' FROM ' San Bernardino ') - 结果为 'San Bernardino' 。 请注意，第二个参数是由空格连接的两个单引号。
UPPER(<string>)	返回所有字符转换成大写后的字符串。 示例 UPPER('Sailboat') - 结果为 'SAILBOAT' 。
LOWER(<string>)	返回所有字符转换成小写后的字符串。 示例 LOWER('Sailboat') - 结果为 'sailboat' 。