转换时间字段 (数据管理)

摘要

将存储在字符串或数值字段中的时间值转换为日期字段。此工具也可用于将以字符串、数值或日期字段形式存储的时间值转换为如一周中周几或一年中第几个月等自定义格式。

使用情况

  • 如果所选择的输入时间字段为字符串或文本字段,可以从支持的时间字段格式列表中选择输入时间格式,或定义自定义的时间字段格式来解释字符串字段中的自定义日期或时间值。有关字符串字段的自定义格式的详细信息,请参阅将字符串时间值转换为日期格式

  • 如果所选择的输入时间字段是数值字段(短整型、长整型、浮点型或双精度),可以从支持的标准时间字段格式列表中选择输入时间格式。数值字段不支持自定义时间格式。

参数

标注说明数据类型
输入表

包含着含有要转换的时间值的字段的图层或表。

Table View
输入时间字段

含有时间值的字段。可能的类型有短整型、长整型、浮点型、双精度、文本或日期。

Field
输入时间格式
(可选)

输入时间字段中的时间值所使用的存储格式。可以从下拉列表中选择标准时间格式,也可以输入自定义格式。

注:

格式字符串区分大小写。

  • 如果时间字段的数据类型为日期,则不需要时间格式。
  • 如果时间字段的数据类型是数值(短整型、长整型、浮点型或双精度),将在下拉列表中提供标准数值时间格式。
  • 如果时间字段的数据类型是字符串,将在下拉列表中提供标准字符串时间格式。对于字符串字段来说,您也可以选择为其指定自定义时间格式。例如,可采用标准格式将时间值存储在字符串字段中,如 yyyy/MM/dd HH:mm:ss 或以自定义格式存储,如 dd/MM/yyyy HH:mm:ss。如果使用自定义格式,您还可以指定 a.m.、p.m. 指示符。以下列出了部分常用格式:
    • yyyy - 年,以四位数表示。
    • MM - 数字形式的月,且个位数有前导零。
    • MMM - 月,以三个字母的缩略形式表示。
    • dd - 数字形式的每月日期,且个位数有前导零。
    • ddd - 星期,以三个字母的缩略形式表示。
    • hh - 小时,且个位数小时具有前导零;12 小时制。
    • HH - 小时,且个位数小时具有前导零;24 小时制。
    • mm - 分钟,且个位数分钟有前导零。
    • ss - 秒,且个位数秒有前导零。
    • t - 单字符时间标记字符串,例如,A 或 P。
    • tt - 多字符时间标记字符串,例如,AM 或 PM。
    • unix_us - Unix 时间,以微秒为单位。
    • unix_ms - Unix 时间,以毫秒为单位。
    • unix_s - Unix 时间,以秒为单位。
    • unix_hex - 以十六进制表示的 Unix 时间。

String
输出时间字段

用于要存储转换的时间值的输出字段的名称。

String
输出时间类型
(可选)

输出时间字段的数据类型。

  • 日期日期和/或时间
  • 文本任何字符串
  • 长整型(大整数)介于 -2,147,483,648 和 2,147,483,647 之间的整数。
  • 短整型(小整数)介于 -32,768 和 32,767 之间的整数。
  • 双精度(双精度)介于 -2.2E308 和 1.8E308 之间的小数
  • 浮点型(单精度)介于 -3.4E38 和 1.2E38 之间的小数
String
输出时间格式
(可选)

保存输出时间值时使用的格式。输出时间格式列表取决于为输出时间字段指定的输出数据类型。如果输出时间字段的数据类型不是日期,也可以使用自定义格式。有关自定义格式的列表,请参阅“输入时间格式”的说明。

注:

如果输出时间字段的数据类型长度不足以存储转换的时间值,将会截断输出值。

String

派生输出

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

已更新的输入表。

表视图

arcpy.management.ConvertTimeField(in_table, input_time_field, {input_time_format}, output_time_field, {output_time_type}, {output_time_format})
名称说明数据类型
in_table

包含着含有要转换的时间值的字段的图层或表。

Table View
input_time_field

含有时间值的字段。可能的类型有短整型、长整型、浮点型、双精度、文本或日期。

Field
input_time_format
(可选)

输入时间字段中的时间值所使用的存储格式。可以从下拉列表中选择标准时间格式,也可以输入自定义格式。

注:

格式字符串区分大小写。

  • 如果时间字段的数据类型为日期,则不需要时间格式。
  • 如果时间字段的数据类型是数值(短整型、长整型、浮点型或双精度),将在下拉列表中提供标准数值时间格式。
  • 如果时间字段的数据类型是字符串,将在下拉列表中提供标准字符串时间格式。对于字符串字段来说,您也可以选择为其指定自定义时间格式。例如,可采用标准格式将时间值存储在字符串字段中,如 yyyy/MM/dd HH:mm:ss 或以自定义格式存储,如 dd/MM/yyyy HH:mm:ss。如果使用自定义格式,您还可以指定 a.m.、p.m. 指示符。以下列出了部分常用格式:
    • yyyy - 年,以四位数表示。
    • MM - 数字形式的月,且个位数有前导零。
    • MMM - 月,以三个字母的缩略形式表示。
    • dd - 数字形式的每月日期,且个位数有前导零。
    • ddd - 星期,以三个字母的缩略形式表示。
    • hh - 小时,且个位数小时具有前导零;12 小时制。
    • HH - 小时,且个位数小时具有前导零;24 小时制。
    • mm - 分钟,且个位数分钟有前导零。
    • ss - 秒,且个位数秒有前导零。
    • t - 单字符时间标记字符串,例如,A 或 P。
    • tt - 多字符时间标记字符串,例如,AM 或 PM。
    • unix_us - Unix 时间,以微秒为单位。
    • unix_ms - Unix 时间,以毫秒为单位。
    • unix_s - Unix 时间,以秒为单位。
    • unix_hex - 以十六进制表示的 Unix 时间。

了解有关自定义日期和时间格式的详细信息

String
output_time_field

用于要存储转换的时间值的输出字段的名称。

String
output_time_type
(可选)

输出时间字段的数据类型。

  • DATE日期和/或时间
  • TEXT任何字符串
  • LONG介于 -2,147,483,648 和 2,147,483,647 之间的整数。
  • SHORT介于 -32,768 和 32,767 之间的整数。
  • DOUBLE介于 -2.2E308 和 1.8E308 之间的小数
  • FLOAT介于 -3.4E38 和 1.2E38 之间的小数
String
output_time_format
(可选)

保存输出时间值时使用的格式。输出时间格式列表取决于为输出时间字段指定的输出数据类型。如果输出时间字段的数据类型不是日期,也可以使用自定义格式。有关自定义格式的列表,请参阅“输入时间格式”的说明。

注:

如果输出时间字段的数据类型长度不足以存储转换的时间值,将会截断输出值。

String

派生输出

名称说明数据类型
out_table

已更新的输入表。

表视图

代码示例

ConvertTimeField 示例 1(Python 窗口)

以下 Python 窗口脚本演示了如何在即时模式下使用 ConvertTimeField 工具。

import arcpy
arcpy.ConvertTimeField_management("C:/Data/TemporalData.gdb/Input_Table","Input_Time","1033;MMMM dd, yyyy HH:mm:ss;AM;PM","Output_Time")
ConvertTimeField 示例 2(独立脚本)

以下独立脚本演示了如何使用 ConvertTimeField 工具。

# Name: ConvertTimeField_Ex02.py
# Description: Convert a time field to date field
# Requirements: None

# Import system modules
import arcpy

# Set local variables
inTable = "C:\Data\TemporalData.gdb\Input_Table"
inputTimeField = "Input_Time"
inputTimeFormat = "1033;MMMM dd, yyyy HH:mm:ss;AM;PM"
outputDateField = "Output_Time"

# Execute CalculateEndDate
arcpy.ConvertTimeField_management(inTable, inputTimeField, inputTimeFormat, outputDateField)

环境

特殊情况

许可信息

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

相关主题