操作方法：使用 Portal for ArcGIS Map Viewer 中的 Arcade 计算弹出窗口中两个日期字段之间的差异

描述

ArcGIS Arcade 是一种表达式语言，可用于在 Portal for ArcGIS Map Viewer 中配置弹出窗口。 Arcade 日期函数提供了创建日期对象和获取对象各种属性的方法。 例如，DateAdd() 和 DateDiff() 函数可用于根据指定的间隔调整所需的日期，而 Now() 函数可用于获取客户端当前的本地时间。

本文提供了计算 Portal for ArcGIS Map Viewer 弹出窗口中两个日期字段之间差异的步骤。 在此示例中，弹出窗口中显示的自上次消防栓检查以来的天数是通过引用“检查日期”字段中的字段值（如下图所示）和客户端当前的本地时间获得的。

解决方案或解决方法

1. 在 Portal for ArcGIS Map Viewer 中打开地图。 单击内容（深色）工具栏上的图层，然后在弹出窗口中选择图层进行编辑。 在此示例中，选择了 Hydrant Painting for Collector 图层。

2. 单击“设置”（浅色）工具栏上的弹出窗口，然后单击选项 > 属性表达式。

3. 单击 + 添加表达式以打开 Arcade 表达式编辑器窗口。
4. 在编辑器窗口中，根据需要为新表达式指定名称。
5. 在表达式对话框中，插入以下 Arcade 表达式：

1. 定义要引用的日期。

var <variableName> = Now()
var <variableName1> = $feature.<date_fieldName>;

2. 计算年份中的日期差异。

var <variableName2> = Floor(DateDiff(<variableName>, <variableName1>, 'years'));

3. 通过将年份添加到开始日期来创建新日期。

var <variableName3> = DateAdd(<variableName1>, <variableName2>, 'years');

4. 计算这些日期之间的天数。

var <variableName4> = DateDiff(<variableName>, <variableName3>, 'days');

5. 定义要在弹出窗口中显示的字段值的约束。

if (IsEmpty($feature.<date_fieldName>)){
    return "<textValue>";
} else if (<variableName2> >= <numberValue>) {
    return "<textValue1> " + <variableName2> + " <textValue2> " + Floor(<variableName4> , <numberValue1>) + " <textValue3>";
} else if (<variableName2> == <numberValue2>) {
    return "<textValue4> " + Floor(<variableName4> , <numberValue1>) + " <textValue3>";
} else if (<variableName2> == <numberValue1> && <variableName4> >= <numberValue>) {
    return "<textValue1> " + Floor(<variableName4> , <numberValue1>) + " <textValue3>";
} else if (<variableName2> == <numberValue1> && <variableName4> >= <numberValue2>) {
    return "<textValue1> " + Floor(<variableName4> , <numberValue1>) + " <textValue5>";
} else if (<variableName2> == <numberValue1> && <variableName4> < <numberValue2>) {
    return "<textValue6>";
}

以下代码块演示了完整的工作 Arcade 脚本。

var timeNow = Now();
var survey = $feature.DATEINSPECTED;
var y = Floor(DateDiff(timeNow, survey, 'years'));
var date1a = DateAdd(survey, y, 'years');
var d = DateDiff(timeNow, date1a, 'days');

if (IsEmpty($feature.DATEINSPECTED)){
    return "-";
} else if (y >= 2) {
    return "Last Inspection: " + y + " years and " + Floor(d , 0) + " days ago.";
} else if (y == 1) {
    return "Last Inspection: 1 year and " + Floor(d , 0) + " days ago.";
} else if (y == 0 && d >= 2) {
    return "Last Inspection: " + Floor(d , 0) + " days ago.";
} else if (y == 0 && d >= 1) {
    return "Last Inspection: " + Floor(d , 0) + " day ago.";
} else if (y == 0 && d < 1) {
    return "Last Inspection: today.";
}

6. 单击测试以查看表达式结果的预览。 如果达到所需的结果，请单击确定。

7. 单击属性表达式窗格中新创建的 Arcade 表达式上方的上一个按钮。

8. 单击字段列表以展开弹出窗口中显示的字段列表，然后单击选择字段。
9. 选中表达式部分下的表达式字段，然后单击完成。

下图显示了使用 ArcGIS Arcade 在弹出窗口中新添加的“上次检查（天）”字段，用于提供自上次检查消防栓以来的天数或年数。