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

摘要

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

使用情况

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

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

参数

对话框

标注	说明	数据类型
输入表	包含待提取日期值的字段所在的图层或表。	Table View
日期字段	将从中提取数据和时间属性以填充新字段值的日期字段。	Field
日期属性	将添加到输入表的日期和时间属性以及字段。 输出时间格式 - 将添加到输出字段名称的日期或时间属性。 输出字段名称 - 将添加到输入表的字段的名称。 输出时间格式选项如下： 小时 - 介于 0 到 23 之间的小时值。 星期全名 - 星期全名，例如，星期三。 星期数值 - 介于 1 到 7 之间的星期值。 月 - 介于 1 到 12 之间的月值。 日 - 介于 1 到 31 之间日值。 年 - 采用 yyyy 格式的年值，例如 1983。	Value Table

派生输出

标注	说明	数据类型
更新的输入表	包含日期属性的已更新输入表。	Table View

Python

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: 是