返回顶部

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

在本主题中

  1. 摘要
  2. 使用情况
  3. 参数
  4. 环境
  5. 许可信息

摘要

将存储在一个字段中的时间值传输到另一个字段。 该工具可用于在字段类型（文本、数值或日期时间字段）之间进行转换，或将值转换为不同的格式（例如 dd/MM/yy HH:mm:ss 到 yyyy-MM-dd）。

使用情况

    警告：

    此工具会修改输入数据。 有关详细信息以及避免数据被意外更改的策略，请参阅修改或更新输入数据的工具。

  • 如果输入时间字段为文本或数值字段，则为输入格式参数指定适当的格式。

    了解有关受支持的时间字段格式的详细信息

  • 如果输入字段参数值为文本字段，则可以将自定义格式添加到输入格式参数。

    对于符合 ISO-8601 格式要求的文本字段，使用 yyyy-MM-ddTHH:mm:ss.s 作为输入格式。 此格式可处理使用 UTC 指示符 (Z) 或 UTC 偏移 (±hh:mm) 的输入。

    了解有关将字符串时间值转换为日期格式的详细信息

  • 采用 yyyy-MM-ddTHH:mm:ss.s 格式的文本字段的输出不支持添加 UTC (Z) 或 UTC 偏移 (±hh:mm) 指示符。

  • 如果指定了时区环境，则默认将使用时区偏移参数的环境值，除非该参数值也已指定。

  • 如果输入字段参数值为日期字段并且输出字段类型参数值为时间戳偏移，则可为时区偏移参数指定字符串类型并选择将统一应用于输出中的所有行的时区。 例如，当选择太平洋标准时间作为值为 2002-08-20 12:00:00 PM 的输入日期字段的偏移时，将生成输出值 2002-08-20 12:00:00 PM -08:00。 输入日期字段中的所有其他行也将应用 -08:00 偏移。

    或者，指定字段理性，然后选择包含时区偏移数据的字段。 字段值可以为数值，例如 -5；或者字符串，例如东部标准时间。 有关支持作为字符串值的所有时区列表，请参阅时区偏移参数。 在指定字段后，工具将使用行值作为偏移值。 当输入行的日期值来自不同时区时，建议将字段用于偏移。 例如，如果输入“日期”字段包含值 2001-01-01 7:00:00 AM、2001-01-02, 9:00:00 AM 和 2001-01-02 12:00:00 PM，并且偏移字段包含值 -8、-5 和 0（表示相应的行），则工具将输出值 2001-01-01 7:00:00 AM -08:00、2001-01-02 9:00:00 AM -05:00 和 2001-01-02 12:00:00 PM +00:00；

    注：
    如果输入字段参数值为日期字段并且输出字段类型参数值为时间戳偏移，则工具不会执行任何时间或日期转换。 如果需要进行时间或日期转换，使用转换时区工具将日期字段转换为相应的日期和时间，然后再使用此工具应用相应的时间戳偏移值。

  • 如果输入字段参数值为时间戳偏移字段并且输出字段类型参数值为日期、仅日期或仅时间字段，则工具会将相应的时间和日期转换为指定的时区偏移参数值。 例如，如果将时间戳偏移字段值 2011-06-02 4:30:00.000 PM -08:00 转换为日期类型，并且时区偏移参数设置为字符串类型和值 UTC，则输出值将为 2011-06-03 12:30:00 AM。

  • 可以将输出格式参数指定为仅时间，但是“仅时间”不会可接受的输入格式参数值。 这是因为仅时间输出格式缺少充足的信息，无法转换为其他格式，例如时间戳偏移、日期或仅日期。

参数

对话框Python

标注说明数据类型
输入表

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

Table View
输入字段

含有时间值的字段。 字段类型可以是短型、长型、浮点型、双精度、文本、日期、时间戳偏移或仅日期。

Field
输入格式
(可选)

输入字段参数值中时间值的格式。 可从下拉列表中选择标准时间格式，也可以指定自定义格式。 当输入时间字段为日期类型时，不支持该参数。

注：

格式字符串区分大小写。

  • 如果时间字段的数据类型为日期、仅日期或时间戳偏移，则不需要时间格式。
  • 如果时间字段的数据类型是数值（短整型、长整型、浮点型、双精度或大整型），将在下拉列表中提供标准数值时间格式。
  • 如果时间字段的数据类型是字符串，将在下拉列表中提供标准字符串时间格式。 如果使用字符串字段，您也可以为其指定自定义时间格式。 例如，可采用标准格式将时间值存储在字符串字段中，如 yyyy/MM/dd HH:mm:ss 或以自定义格式存储，如 dd/MM/yyyy HH:mm:ss。 如果使用自定义格式，您还可以指定 a.m. 或 p.m. 指示符。
  • 对于符合 ISO-8601 要求的字符串，使用 yyyy-MM-ddTHH:mm:ss.s 作为输入格式。 此输入选择可处理使用 UTC 指示符 (Z) 或 UTC 偏移 (±hh:mm) 的输入。
  • 下面列出了常用的格式：
    • 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
输出字段类型
(可选)

指定输出时间字段的字段类型。

  • 仅日期—此字段类型将仅为日期。 仅日期字段支持不带时间值的日期值。
  • 日期—字段类型将为日期型。 日期字段支持日期和时间值。
  • 仅时间—此字段类型将仅为时间。 仅时间字段支持不带日期值的时间值。
  • 时间戳偏移—此字段类型将为时间戳偏移。 时间戳偏移字段支持日期、时间和相对于 UTC 值的偏移。
  • 文本—字段类型将为文本型。 文本字段支持字符串。
  • 长整型（32 位整型）—字段类型将为长整型。 长整型字段支持介于 2,147,483,648 和 2,147,483,647 之间的整数。
  • 短整型（16 位整型）—字段类型将为短整型。 短整形字段支持介于 -32,768 和 32,767 之间的整数。
  • 双精度型（64 位浮点型）—字段类型将为双精度型。 双精度字段支持介于 -2.2E308 和 1.8E308 之间的小数。
  • 浮点型（32 位浮点型）—字段类型将为浮点型。 浮点型字段支持介于 -3.4E38 和 1.2E38 之间的小数。
  • 大整型（64 位整数）—此字段类型将为大整数。 大整数字段支持 -(253) 和 253 之间的整数。
String
输出格式
(可选)

输出时间值的格式。 支持的输出时间格式取决于输出字段类型参数值。 自定义格式还可用于将值转换为不同格式或提取值的一部分（例如年份）。 有关自定义格式的列表，请参阅输入格式参数说明。 当输出字段类型参数值为日期时，不使用此参数。

注：

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

String
时区偏移
(可选)

要用作输出时区的时区或字段，包含相对于输入表的数值偏移。

如果指定了时区环境，则该工具默认将使用该环境值。

  • UTC—时区将为 UTC。
  • 国际日期变更线标准时间—时区将为国际日期变更线标准时间 (UTC-12:00)。
  • UTC-11—时区将为 UTC-11 (UTC-11:00)。
  • 阿留申标准时间—时区将为阿留申标准时间 (UTC-10:00)。
  • 夏威夷标准时间—时区将为夏威夷标准时间 (UTC-10:00)。
  • 马克萨斯标准时间—时区将为马克萨斯标准时间 (UTC-09:30)。
  • 阿拉斯加标准时间—时区将为阿拉斯加标准时间 (UTC-09:00)。
  • UTC-09—时区将为 UTC-09 (UTC-09:00)。
  • 太平洋标准时间(墨西哥)—时区将为太平洋标准时间（墨西哥）(UTC-08:00)。
  • UTC-08—时区将为 UTC-08 (UTC-08:00)。
  • 太平洋标准时间—时区将为太平洋标准时间 (UTC-08:00)。
  • 美国山区标准时间—时区将为美国山区标准时间 (UTC-07:00)。
  • 山区标准时间(墨西哥)—时区将为山区标准时间（墨西哥）(UTC-07:00)。
  • 山区标准时间—时区将为山区标准时间 (UTC-07:00)。
  • 育空标准时间—时区将为育空标准时间 (UTC-07:00)。
  • 中美洲标准时间—时区将为中美洲标准时间 (UTC-06:00)。
  • 中部标准时间—时区将为中部标准时间 (UTC-06:00)。
  • 复活节岛标准时间—时区将为复活节岛标准时间 (UTC-06:00)。
  • 中部标准时间(墨西哥)—时区将为中部标准时间（墨西哥）(UTC-06:00)。
  • 加拿大中部标准时间—时区将为加拿大中部标准时间 (UTC-06:00)。
  • SA 太平洋标准时间—时区将为 SA 太平洋标准时间 (UTC-05:00)。
  • 东部标准时间(墨西哥)—时区将为东部标准时间（墨西哥）(UTC-05:00)。
  • 东部标准时间—时区将为东部标准时间 (UTC-05:00)。
  • 海地标准时间—时区将为海地标准时间 (UTC-05:00)。
  • 古巴标准时间—时区将为古巴标准时间 (UTC-05:00)。
  • 美国东部标准时间—时区将为美国东部标准时间 (UTC-05:00)。
  • 特克斯和凯科斯标准时间—时区将为特克斯和凯科斯标准时间 (UTC-04:00)。
  • 巴拉圭标准时间—时区将为巴拉圭标准时间 (UTC-04:00)。
  • 大西洋标准时间—时区将为大西洋标准时间 (UTC-04:00)。
  • 委内瑞拉标准时—时区将为委内瑞拉标准时间 (UTC-04:00)。
  • 中部巴西标准时间—时区将为中部巴西标准时间 (UTC-04:00)。
  • SA 西部标准时间—时区将为 SA 西部标准时间 (UTC-04:00)。
  • 太平洋 SA 标准时间—时区将为太平洋 SA 标准时间 (UTC-04:00)。
  • 纽芬兰标准时间—时区将为纽芬兰标准时间 (UTC-03:30)。
  • 托坎廷斯标准时间—时区将为托坎廷斯标准时间 (UTC-03:00)。
  • 东南美洲标准时间—时区将为东南美洲标准时间 (UTC-03:00)。
  • SA 东部标准时间—时区将为 SA 东部标准时间 (UTC-03:00)。
  • 阿根廷标准时间—时区将为阿根廷标准时间 (UTC-03:00)。
  • 格陵兰岛标准时间—时区将为格陵兰岛标准时间 (UTC-03:00)。
  • 蒙得维的亚标准时间—时区将为蒙得维的亚标准时间 (UTC-03:00)。
  • 麦哲伦标准时间—时区将为麦哲伦标准时间 (UTC-03:00)。
  • 圣皮埃尔标准时间—时区将为圣皮埃尔标准时间 (UTC-03:00)。
  • 巴伊亚标准时间—时区将为巴伊亚标准时间 (UTC-03:00)。
  • UTC-02—时区将为 UTC-02 (UTC-02:00)。
  • 中部大西洋标准时间—时区将为中部大西洋标准时间 (UTC-02:00)。
  • 亚速尔群岛标准时间—时区将为亚速尔群岛标准时间 (UTC-01:00)。
  • 佛得角标准时间—时区将为佛得角标准时间 (UTC-01:00)。
  • GMT 标准时间—时区将为 GMT 标准时间 (UTC+00:00)。
  • 格林尼治标准时间—时区将为格林尼治标准时间 (UTC+00:00)。
  • 圣多美标准时间—时区将为圣多美标准时间 (UTC+00:00)。
  • 摩洛哥标准时间—时区将为摩洛哥标准时间 (UTC+00:00)。
  • 西欧标准时间—时区将为西欧标准时间 (UTC+01:00)。
  • 中欧标准时间—时区将为中欧标准时间 (UTC+01:00)。
  • 罗曼标准时间—时区将为罗曼标准时间 (UTC+01:00)。
  • 中欧标准时间—时区将为中欧标准时间 (UTC+01:00)。
  • 中非西部标准时间—时区将为中非西部标准时间 (UTC+01:00)。
  • 约旦标准时间—时区将为约旦标准时间 (UTC+02:00)。
  • GTB 标准时间—时区将为 GTB 标准时间 (UTC+02:00)。
  • 中东标准时间—时区将为中东标准时间 (UTC+02:00)。
  • 埃及标准时间—时区将为埃及标准时间 (UTC+02:00)。
  • 东欧标准时间—时区将为东欧标准时间 (UTC+02:00)。
  • 叙利亚标准时间—时区将为叙利亚标准时间 (UTC+02:00)。
  • 西岸标准时间—时区将为西岸标准时间 (UTC+02:00)。
  • 南非标准时间—时区将为南非标准时间 (UTC+02:00)。
  • FLE 标准时间—时区将为 FLE 标准时间 (UTC+02:00)。
  • 以色列标准时间—时区将为以色列标准时间 (UTC+02:00)。
  • 南苏丹标准时间—时区将为南苏丹标准时间 (UTC+02:00)。
  • 加里宁格勒标准时间—时区将为加里宁格勒标准时间 (UTC+02:00)。
  • 苏丹标准时间—时区将为苏丹标准时间 (UTC+02:00)。
  • 利比亚标准时间—时区将为利比亚标准时间 (UTC+02:00)。
  • 纳米比亚标准时间—时区将为纳米比亚标准时间 (UTC+02:00)。
  • 阿拉伯标准时间—时区将为阿拉伯标准时间 (UTC+03:00)。
  • 土耳其标准时间—时区将为土耳其标准时间 (UTC+03:00)。
  • 阿拉伯标准时间—时区将为阿拉伯标准时间 (UTC+03:00)。
  • 白俄罗斯标准时间—时区将为白俄罗斯标准时间 (UTC+03:00)。
  • 俄罗斯标准时间—时区将为俄罗斯标准时间 (UTC+03:00)。
  • 东非标准时间—时区将为东非标准时间 (UTC+03:00)。
  • 伏尔加格勒标准时间—时区将为伏尔加格勒标准时间 (UTC+03:00)。
  • 伊朗标准时间—时区将为伊朗标准时间 (UTC+03:30)。
  • 阿拉伯标准时间—时区将为阿拉伯标准时间 (UTC+04:00)。
  • 阿斯特拉罕标准时间—时区将为阿斯特拉罕标准时间 (UTC+04:00)。
  • 阿塞拜疆标准时间—时区将为阿塞拜疆标准时间 (UTC+04:00)。
  • 俄罗斯时区 3—时区将为俄罗斯时区 3 (UTC+04:00)。
  • 毛里求斯标准时间—时区将为毛里求斯标准时间 (UTC+04:00)。
  • 萨拉托夫标准时间—时区将为萨拉托夫标准时间 (UTC+04:00)。
  • 乔治亚州标准时间—时区将为乔治亚州标准时间 (UTC+04:00)。
  • 高加索标准时间—时区将为高加索标准时间 (UTC+04:00)。
  • 阿富汗标准时间—时区将为阿富汗标准时间 (UTC+04:30)。
  • 西亚标准时间—时区将为西亚标准时间 (UTC+05:00)。
  • 叶卡捷琳堡标准时间—时区将为叶卡捷琳堡标准时间 (UTC+05:00)。
  • 巴基斯坦标准时间—时区将为巴基斯坦标准时间 (UTC+05:00)。
  • 克孜勒奥尔达标准时间—时区将为克孜勒奥尔达标准时间 (UTC+05:00)。
  • 印度标准时间—时区将为印度标准时间 (UTC+05:30)。
  • 斯里兰卡标准时间—时区将为斯里兰卡标准时间 (UTC+05:30)。
  • 尼泊尔标准时间—时区将为尼泊尔标准时间 (UTC+05:45)。
  • 中亚标准时间—时区将为中亚标准时间 (UTC+06:00)。
  • 孟加拉国标准时间—时区将为孟加拉国标准时间 (UTC+06:00)。
  • 鄂木斯克标准时间—时区将为鄂木斯克标准时间 (UTC+06:00)。
  • 缅甸标准时间—时区将为缅甸标准时间 (UTC+06:30)。
  • 东南亚标准时间—时区将为东南亚标准时间 (UTC+07:00)。
  • 阿尔泰标准时间—时区将为阿尔泰标准时间 (UTC+07:00)。
  • 西蒙古标准时间—时区将为西蒙古标准时间 (UTC+07:00)。
  • 北亚标准时间—时区将为北亚标准时间 (UTC+07:00)。
  • 中亚南部标准时间—时区将为中亚南部标准时间 (UTC+07:00)。
  • 托木斯克标准时间—时区将为托木斯克标准时间 (UTC+07:00)。
  • 中国标准时间—时区将为中国标准时间 (UTC+08:00)。
  • 北亚东部标准时间—时区将为北亚东部标准时间 (UTC+08:00)。
  • 新加坡标准时间—时区将为新加坡标准时间 (UTC+08:00)。
  • 西部澳大利亚标准时间—时区将为西部澳大利亚标准时间 (UTC+08:00)。
  • 台北标准时间—时区将为台北标准时间 (UTC+08:00)。
  • 乌兰巴托标准时间—时区将为乌兰巴托标准时间 (UTC+08:00)。
  • 澳大利亚中西部标准时间—时区将为澳大利亚中西部标准时间 (UTC+08:45)。
  • 外贝加尔标准时间—时区将为外贝加尔标准时间 (UTC+09:00)。
  • 东京标准时间—时区将为东京标准时间 (UTC+09:00)。
  • 朝鲜标准时间—时区将为朝鲜标准时间 (UTC+09:00)。
  • 韩国标准时间—时区将为韩国标准时间 (UTC+09:00)。
  • 雅库茨克标准时间—时区将为雅库茨克标准时间 (UTC+09:00)。
  • 中部 澳大利亚标准时间—时区将为中部。 澳大利亚标准时间 (UTC+09:30)。
  • 澳大利亚中部标准时间—时区将为澳大利亚中部标准时间 (UTC+09:30)。
  • 东部澳大利亚标准时间—时区将为东部澳大利亚标准时间 (UTC+10:00)。
  • 澳大利亚东部标准时间—时区将为澳大利亚东部标准时间 (UTC+10:00)。
  • 西太平洋标准时间—时区将为西太平洋标准时间 (UTC+10:00)。
  • 塔斯马尼亚标准时间—时区将为塔斯马尼亚标准时间 (UTC+10:00)。
  • 符拉迪沃斯托克标准时间—时区将为符拉迪沃斯托克标准时间 (UTC+10:00)。
  • 豪勋爵标准时间—时区将为豪勋爵标准时间 (UTC+10:30)。
  • 布干维尔标准时间—时区将为布干维尔标准时间 (UTC+11:00)。
  • 俄罗斯时区 10—时区将为俄罗斯时区 10 (UTC+11:00)。
  • 马加丹标准时间—时区将为马加丹标准时间 (UTC+11:00)。
  • 诺福克标准时间—时区将为诺福克标准时间 (UTC+11:00)。
  • 萨哈林标准时间—时区将为萨哈林标准时间 (UTC+11:00)。
  • 中太平洋标准时间—时区将为中太平洋标准时间 (UTC+11:00)。
  • 俄罗斯时区 11—时区将为俄罗斯时区 11 (UTC+11:00)。
  • 新西兰标准时间—时区将为新西兰标准时间 (UTC+12:00)。
  • UTC+12—时区将为 UTC+12 (UTC+12:00)。
  • 斐济标准时间—时区将为斐济标准时间 (UTC+12:00)。
  • 堪察加标准时间—时区将为堪察加标准时间 (UTC+12:00)。
  • 查塔姆群岛标准时间—时区将为查塔姆群岛标准时间 (UTC+12:45)。
  • UTC+13—时区将为 UTC+13 (UTC+13:00)。
  • 东加群岛标准时间—时区将为东加群岛标准时间 (UTC+13:00)。
  • 萨摩亚标准时间—时区将为萨摩亚标准时间 (UTC+13:00)。
  • 莱恩群岛标准时间—时区将为莱恩群岛标准时间 (UTC+14:00)。
String; Field

派生输出

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

更新的输入表。

Table View

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

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

Table View
input_time_field

含有时间值的字段。 字段类型可以是短型、长型、浮点型、双精度、文本、日期、时间戳偏移或仅日期。

Field
input_time_format
(可选)

input_time_field 参数值中时间值的格式。 当输入时间字段为日期类型时，不支持该参数。

注：

格式字符串区分大小写。

  • 如果时间字段的数据类型为日期、仅日期或时间戳偏移，则不需要时间格式。
  • 如果时间字段的数据类型是数值（短整型、长整型、浮点型、双精度或大整型），将在下拉列表中提供标准数值时间格式。
  • 如果时间字段的数据类型是字符串，将在下拉列表中提供标准字符串时间格式。 如果使用字符串字段，您也可以为其指定自定义时间格式。 例如，可采用标准格式将时间值存储在字符串字段中，如 yyyy/MM/dd HH:mm:ss 或以自定义格式存储，如 dd/MM/yyyy HH:mm:ss。 如果使用自定义格式，您还可以指定 a.m. 或 p.m. 指示符。
  • 对于符合 ISO-8601 要求的字符串，使用 yyyy-MM-ddTHH:mm:ss.s 作为输入格式。 此输入选择可处理使用 UTC 指示符 (Z) 或 UTC 偏移 (±hh:mm) 的输入。
  • 下面列出了常用的格式：
    • 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—字段类型将为日期型。 日期字段支持日期和时间值。
  • DATEONLY—此字段类型将仅为日期。 仅日期字段支持不带时间值的日期值。
  • TIMEONLY—此字段类型将仅为时间。 仅时间字段支持不带日期值的时间值。
  • TIMESTAMPOFFSET—此字段类型将为时间戳偏移。 时间戳偏移字段支持日期、时间和相对于 UTC 值的偏移。
  • 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 之间的小数。
  • BIGINTEGER—此字段类型将为大整数。 大整数字段支持 -(253) 和 253 之间的整数。
String
output_time_format
(可选)

输出时间值的格式。 支持的输出时间格式取决于 output_time_type 参数值。 自定义格式还可用于将值转换为不同格式或提取值的一部分（例如年份）。 有关自定义格式的列表，请参阅 input_time_format 参数说明。 当 output_time_type 参数值为 DATE 时，不使用此参数。

注：

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

String
timezone_or_field
(可选)

要用作输出时区的时区或字段，包含相对于输入表的数值偏移。

如果指定了时区环境，则该工具默认将使用该环境值。

  • UTC—时区将为 UTC。
  • Dateline_Standard_Time—时区将为国际日期变更线标准时间 (UTC-12:00)。
  • UTC-11—时区将为 UTC-11 (UTC-11:00)。
  • Aleutian_Standard_Time—时区将为阿留申标准时间 (UTC-10:00)。
  • Hawaiian_Standard_Time—时区将为夏威夷标准时间 (UTC-10:00)。
  • Marquesas_Standard_Time—时区将为马克萨斯标准时间 (UTC-09:30)。
  • Alaskan_Standard_Time—时区将为阿拉斯加标准时间 (UTC-09:00)。
  • UTC-09—时区将为 UTC-09 (UTC-09:00)。
  • Pacific_Standard_Time_(Mexico)—时区将为太平洋标准时间（墨西哥）(UTC-08:00)。
  • UTC-08—时区将为 UTC-08 (UTC-08:00)。
  • Pacific_Standard_Time—时区将为太平洋标准时间 (UTC-08:00)。
  • US_Mountain_Standard_Time—时区将为美国山区标准时间 (UTC-07:00)。
  • Mountain_Standard_Time_(Mexico)—时区将为山区标准时间（墨西哥）(UTC-07:00)。
  • Mountain_Standard_Time—时区将为山区标准时间 (UTC-07:00)。
  • Yukon_Standard_Time—时区将为育空标准时间 (UTC-07:00)。
  • Central_America_Standard_Time—时区将为中美洲标准时间 (UTC-06:00)。
  • Central_Standard_Time—时区将为中部标准时间 (UTC-06:00)。
  • Easter_Island_Standard_Time—时区将为复活节岛标准时间 (UTC-06:00)。
  • Central_Standard_Time_(Mexico)—时区将为中部标准时间（墨西哥）(UTC-06:00)。
  • Canada_Central_Standard_Time—时区将为加拿大中部标准时间 (UTC-06:00)。
  • SA_Pacific_Standard_Time—时区将为 SA 太平洋标准时间 (UTC-05:00)。
  • Eastern_Standard_Time_(Mexico)—时区将为东部标准时间（墨西哥）(UTC-05:00)。
  • Eastern_Standard_Time—时区将为东部标准时间 (UTC-05:00)。
  • Haiti_Standard_Time—时区将为海地标准时间 (UTC-05:00)。
  • Cuba_Standard_Time—时区将为古巴标准时间 (UTC-05:00)。
  • US_Eastern_Standard_Time—时区将为美国东部标准时间 (UTC-05:00)。
  • Turks_And_Caicos_Standard_Time—时区将为特克斯和凯科斯标准时间 (UTC-04:00)。
  • Paraguay_Standard_Time—时区将为巴拉圭标准时间 (UTC-04:00)。
  • Atlantic_Standard_Time—时区将为大西洋标准时间 (UTC-04:00)。
  • Venezuela_Standard_Time—时区将为委内瑞拉标准时间 (UTC-04:00)。
  • Central_Brazilian_Standard_Time—时区将为中部巴西标准时间 (UTC-04:00)。
  • SA_Western_Standard_Time—时区将为 SA 西部标准时间 (UTC-04:00)。
  • Pacific_SA_Standard_Time—时区将为太平洋 SA 标准时间 (UTC-04:00)。
  • Newfoundland_Standard_Time—时区将为纽芬兰标准时间 (UTC-03:30)。
  • Tocantins_Standard_Time—时区将为托坎廷斯标准时间 (UTC-03:00)。
  • E._South_America_Standard_Time—时区将为东南美洲标准时间 (UTC-03:00)。
  • SA_Eastern_Standard_Time—时区将为 SA 东部标准时间 (UTC-03:00)。
  • Argentina_Standard_Time—时区将为阿根廷标准时间 (UTC-03:00)。
  • Greenland_Standard_Time—时区将为格陵兰岛标准时间 (UTC-03:00)。
  • Montevideo_Standard_Time—时区将为蒙得维的亚标准时间 (UTC-03:00)。
  • Magallanes_Standard_Time—时区将为麦哲伦标准时间 (UTC-03:00)。
  • Saint_Pierre_Standard_Time—时区将为圣皮埃尔标准时间 (UTC-03:00)。
  • Bahia_Standard_Time—时区将为巴伊亚标准时间 (UTC-03:00)。
  • UTC-02—时区将为 UTC-02 (UTC-02:00)。
  • Mid-Atlantic_Standard_Time—时区将为中部大西洋标准时间 (UTC-02:00)。
  • Azores_Standard_Time—时区将为亚速尔群岛标准时间 (UTC-01:00)。
  • Cape_Verde_Standard_Time—时区将为佛得角标准时间 (UTC-01:00)。
  • GMT_Standard_Time—时区将为 GMT 标准时间 (UTC+00:00)。
  • Greenwich_Standard_Time—时区将为格林尼治标准时间 (UTC+00:00)。
  • Sao_Tome_Standard_Time—时区将为圣多美标准时间 (UTC+00:00)。
  • Morocco_Standard_Time—时区将为摩洛哥标准时间 (UTC+00:00)。
  • W._Europe_Standard_Time—时区将为西欧标准时间 (UTC+01:00)。
  • Central_Europe_Standard_Time—时区将为中欧标准时间 (UTC+01:00)。
  • Romance_Standard_Time—时区将为罗曼标准时间 (UTC+01:00)。
  • Central_European_Standard_Time—时区将为中欧标准时间 (UTC+01:00)。
  • W._Central_Africa_Standard_Time—时区将为中非西部标准时间 (UTC+01:00)。
  • Jordan_Standard_Time—时区将为约旦标准时间 (UTC+02:00)。
  • GTB_Standard_Time—时区将为 GTB 标准时间 (UTC+02:00)。
  • Middle_East_Standard_Time—时区将为中东标准时间 (UTC+02:00)。
  • Egypt_Standard_Time—时区将为埃及标准时间 (UTC+02:00)。
  • E._Europe_Standard_Time—时区将为东欧标准时间 (UTC+02:00)。
  • Syria_Standard_Time—时区将为叙利亚标准时间 (UTC+02:00)。
  • West_Bank_Standard_Time—时区将为西岸标准时间 (UTC+02:00)。
  • South_Africa_Standard_Time—时区将为南非标准时间 (UTC+02:00)。
  • FLE_Standard_Time—时区将为 FLE 标准时间 (UTC+02:00)。
  • Israel_Standard_Time—时区将为以色列标准时间 (UTC+02:00)。
  • South_Sudan_Standard_Time—时区将为南苏丹标准时间 (UTC+02:00)。
  • Kaliningrad_Standard_Time—时区将为加里宁格勒标准时间 (UTC+02:00)。
  • Sudan_Standard_Time—时区将为苏丹标准时间 (UTC+02:00)。
  • Libya_Standard_Time—时区将为利比亚标准时间 (UTC+02:00)。
  • Namibia_Standard_Time—时区将为纳米比亚标准时间 (UTC+02:00)。
  • Arabic_Standard_Time—时区将为阿拉伯标准时间 (UTC+03:00)。
  • Turkey_Standard_Time—时区将为土耳其标准时间 (UTC+03:00)。
  • Arab_Standard_Time—时区将为阿拉伯标准时间 (UTC+03:00)。
  • Belarus_Standard_Time—时区将为白俄罗斯标准时间 (UTC+03:00)。
  • Russian_Standard_Time—时区将为俄罗斯标准时间 (UTC+03:00)。
  • E._Africa_Standard_Time—时区将为东非标准时间 (UTC+03:00)。
  • Volgograd_Standard_Time—时区将为伏尔加格勒标准时间 (UTC+03:00)。
  • Iran_Standard_Time—时区将为伊朗标准时间 (UTC+03:30)。
  • Arabian_Standard_Time—时区将为阿拉伯标准时间 (UTC+04:00)。
  • Astrakhan_Standard_Time—时区将为阿斯特拉罕标准时间 (UTC+04:00)。
  • Azerbaijan_Standard_Time—时区将为阿塞拜疆标准时间 (UTC+04:00)。
  • Russia_Time_Zone_3—时区将为俄罗斯时区 3 (UTC+04:00)。
  • Mauritius_Standard_Time—时区将为毛里求斯标准时间 (UTC+04:00)。
  • Saratov_Standard_Time—时区将为萨拉托夫标准时间 (UTC+04:00)。
  • Georgian_Standard_Time—时区将为乔治亚州标准时间 (UTC+04:00)。
  • Caucasus_Standard_Time—时区将为高加索标准时间 (UTC+04:00)。
  • Afghanistan_Standard_Time—时区将为阿富汗标准时间 (UTC+04:30)。
  • West_Asia_Standard_Time—时区将为西亚标准时间 (UTC+05:00)。
  • Ekaterinburg_Standard_Time—时区将为叶卡捷琳堡标准时间 (UTC+05:00)。
  • Pakistan_Standard_Time—时区将为巴基斯坦标准时间 (UTC+05:00)。
  • Qyzylorda_Standard_Time—时区将为克孜勒奥尔达标准时间 (UTC+05:00)。
  • India_Standard_Time—时区将为印度标准时间 (UTC+05:30)。
  • Sri_Lanka_Standard_Time—时区将为斯里兰卡标准时间 (UTC+05:30)。
  • Nepal_Standard_Time—时区将为尼泊尔标准时间 (UTC+05:45)。
  • Central_Asia_Standard_Time—时区将为中亚标准时间 (UTC+06:00)。
  • Bangladesh_Standard_Time—时区将为孟加拉国标准时间 (UTC+06:00)。
  • Omsk_Standard_Time—时区将为鄂木斯克标准时间 (UTC+06:00)。
  • Myanmar_Standard_Time—时区将为缅甸标准时间 (UTC+06:30)。
  • SE_Asia_Standard_Time—时区将为东南亚标准时间 (UTC+07:00)。
  • Altai_Standard_Time—时区将为阿尔泰标准时间 (UTC+07:00)。
  • W._Mongolia_Standard_Time—时区将为西蒙古标准时间 (UTC+07:00)。
  • North_Asia_Standard_Time—时区将为北亚标准时间 (UTC+07:00)。
  • N._Central_Asia_Standard_Time—时区将为中亚南部标准时间 (UTC+07:00)。
  • Tomsk_Standard_Time—时区将为托木斯克标准时间 (UTC+07:00)。
  • China_Standard_Time—时区将为中国标准时间 (UTC+08:00)。
  • North_Asia_East_Standard_Time—时区将为北亚东部标准时间 (UTC+08:00)。
  • Singapore_Standard_Time—时区将为新加坡标准时间 (UTC+08:00)。
  • W._Australia_Standard_Time—时区将为西部澳大利亚标准时间 (UTC+08:00)。
  • Taipei_Standard_Time—时区将为台北标准时间 (UTC+08:00)。
  • Ulaanbaatar_Standard_Time—时区将为乌兰巴托标准时间 (UTC+08:00)。
  • Aus_Central_W._Standard_Time—时区将为澳大利亚中西部标准时间 (UTC+08:45)。
  • Transbaikal_Standard_Time—时区将为外贝加尔标准时间 (UTC+09:00)。
  • Tokyo_Standard_Time—时区将为东京标准时间 (UTC+09:00)。
  • North_Korea_Standard_Time—时区将为朝鲜标准时间 (UTC+09:00)。
  • Korea_Standard_Time—时区将为韩国标准时间 (UTC+09:00)。
  • Yakutsk_Standard_Time—时区将为雅库茨克标准时间 (UTC+09:00)。
  • Cen._Australia_Standard_Time—时区将为中部。 澳大利亚标准时间 (UTC+09:30)。
  • AUS_Central_Standard_Time—时区将为澳大利亚中部标准时间 (UTC+09:30)。
  • E._Australia_Standard_Time—时区将为东部澳大利亚标准时间 (UTC+10:00)。
  • AUS_Eastern_Standard_Time—时区将为澳大利亚东部标准时间 (UTC+10:00)。
  • West_Pacific_Standard_Time—时区将为西太平洋标准时间 (UTC+10:00)。
  • Tasmania_Standard_Time—时区将为塔斯马尼亚标准时间 (UTC+10:00)。
  • Vladivostok_Standard_Time—时区将为符拉迪沃斯托克标准时间 (UTC+10:00)。
  • Lord_Howe_Standard_Time—时区将为豪勋爵标准时间 (UTC+10:30)。
  • Bougainville_Standard_Time—时区将为布干维尔标准时间 (UTC+11:00)。
  • Russia_Time_Zone_10—时区将为俄罗斯时区 10 (UTC+11:00)。
  • Magadan_Standard_Time—时区将为马加丹标准时间 (UTC+11:00)。
  • Norfolk_Standard_Time—时区将为诺福克标准时间 (UTC+11:00)。
  • Sakhalin_Standard_Time—时区将为萨哈林标准时间 (UTC+11:00)。
  • Central_Pacific_Standard_Time—时区将为中太平洋标准时间 (UTC+11:00)。
  • Russia_Time_Zone_11—时区将为俄罗斯时区 11 (UTC+11:00)。
  • New_Zealand_Standard_Time—时区将为新西兰标准时间 (UTC+12:00)。
  • UTC+12—时区将为 UTC+12 (UTC+12:00)。
  • Fiji_Standard_Time—时区将为斐济标准时间 (UTC+12:00)。
  • Kamchatka_Standard_Time—时区将为堪察加标准时间 (UTC+12:00)。
  • Chatham_Islands_Standard_Time—时区将为查塔姆群岛标准时间 (UTC+12:45)。
  • UTC+13—时区将为 UTC+13 (UTC+13:00)。
  • Tonga_Standard_Time—时区将为东加群岛标准时间 (UTC+13:00)。
  • Samoa_Standard_Time—时区将为萨摩亚标准时间 (UTC+13:00)。
  • Line_Islands_Standard_Time—时区将为莱恩群岛标准时间 (UTC+14:00)。
String; Field

派生输出

名称说明数据类型
out_table

更新的输入表。

Table View

代码示例

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)

环境

当前工作空间, 时区

相关主题

  • 字段工具集概览
  • 查找地理处理工具

有关此主题的反馈?

在本主题中
  1. 摘要
  2. 使用情况
  3. 参数
  4. 环境
  5. 许可信息