添加日期属性 (犯罪分析和安全)

摘要

添加包含输入日期字段中的日期或时间属性的字段,例如星期全名、日、月和年。

使用情况

  • 当现有字段名称与定义的输出字段名称相同时,现有字段将在输入表值中被覆盖。

  • 日期字段参数值更新之后,新字段的值不会自动更新。 在更新日期字段参数之后运行此工具。

参数

标注说明数据类型
输入表

包含待提取日期值的字段所在的图层或表。

Table View
日期字段

将从中提取数据和时间属性以填充新字段值的日期字段。

Field
日期属性

将添加到输入表的日期和时间属性以及字段。

  • 输出时间格式 - 将添加到输出字段名称的日期或时间属性。
  • 输出字段名称 - 将添加到输入表的字段的名称。

输出时间格式选项如下:

  • 小时 - 介于 0 到 23 之间的小时值。
  • 星期全名 - 星期全名,例如,星期三。
  • 星期数值 - 介于 1 到 7 之间的星期值。
  • - 介于 1 到 12 之间的月值。
  • - 介于 1 到 31 之间日值。
  • - 采用 yyyy 格式的年值,例如 1983。
Value Table

派生输出

标注说明数据类型
更新的输入表

包含日期属性的已更新输入表。

Table View

arcpy.ca.AddDateAttributes(in_table, date_field, date_attributes)
名称说明数据类型
in_table

包含待提取日期值的字段所在的图层或表。

Table View
date_field

将从中提取数据和时间属性以填充新字段值的日期字段。

Field
date_attributes
[date_attributes,...]

将添加到输入表的日期和时间属性以及字段。

  • 输出时间格式 - 将添加到输出字段名称的日期或时间属性。
  • 输出字段名称 - 将添加到输入表的字段的名称。

输出时间格式选项如下:

  • 小时 - 介于 0 到 23 之间的小时值。
  • 星期全名 - 星期全名,例如,星期三。
  • 星期数值 - 介于 1 到 7 之间的星期值。
  • - 介于 1 到 12 之间的月值。
  • - 介于 1 到 31 之间日值。
  • - 采用 yyyy 格式的年值,例如 1983。
Value Table

派生输出

名称说明数据类型
out_table

包含日期属性的已更新输入表。

Table View

代码示例

AddDateAttributes 示例 1(Python 窗口)

以下 Python 窗口脚本演示了如何在即时模式下使用 AddDateAttributes 函数。

import arcpy
arcpy.env.workspace = r"C:\data\city_pd.gdb"
arcpy.ca.AddDateAttributes("CallsForService", "CALLDATE")
AddDateAttributes 示例 2(独立脚本)

以下 Python 脚本演示了如何在独立脚本中使用 AddDateAttributes 函数。

# Name: AddDateAttributes.py
# Description: Add fields for hour, day full name, month, day of the month, 
#              and year to the calls for service data based on the call date 
#              field.

# Import system modules
import arcpy

# Set environment settings
arcpy.env.workspace = r"C:/data/city_pd.gdb"

# Set local variables
in_features = "CallsForService"
date_field = "CALLDATE"

# Customize the name of output date attribute fields
# ["Output Time Format", "Output Field Name"]
day_name_field = ["DAY_FULL_NAME", "CALL_DAYOFWEEK"]
hour_field = ["HOUR", "CALL_HOUR"]
month_field = ["MONTH", "CALL_MONTH"]
day_num_field = ["DAY_OF_MONTH", "CALL_DAY"]
year_field = ["YEAR", "CALL_YEAR"]

date_attributes = [day_name_field, hour_field, month_field, day_num_field, 
                   year_field]

# Execute AddDateAttributes
arcpy.ca.AddDateAttributes(in_features, date_field, date_attributes)

环境

特殊情况

许可信息

  • Basic: 是
  • Standard: 是
  • Advanced: 是

相关主题