Convertir campo de tiempo

Resumen

Convierte valores de tiempo almacenados en un campo numérico o de cadena a un campo de fecha. La herramienta también se puede utilizar para convertir valores de tiempo almacenados en campos de cadena de caracteres, numéricos o de fecha en formatos personalizados como, por ejemplo, el día de la semana y el mes del año.

Uso

• Si el campo de tiempo de entrada que se seleccionó es un campo de texto o de cadena de caracteres, el formato de tiempo de entrada se puede seleccionar de una lista de formatos de campos de tiempo compatibles o puede definir un formato de campo de tiempo personalizado para interpretar valores de fecha o tiempo personalizados en el campo de cadena de caracteres. Para obtener más información sobre formatos personalizados para campos de cadenas de caracteres, consulte convertir valores de tiempo de cadena de caracteres a formato de fecha.

• Si el campo de tiempo de entrada que seleccionó es numérico (corto, largo, flotante o doble), el formato de tiempo de entrada se puede seleccionar de una lista de formatos de campos de tiempo estándar compatibles. Los formatos de tiempo personalizados no son compatibles con los campos numéricos.

Sintaxis

ConvertTimeField_management (in_table, input_time_field, {input_time_format}, output_time_field, {output_time_type}, {output_time_format})

Parámetro	Explicación	Tipo de datos
in_table	La capa o tabla que contiene el campo que contiene los valores de hora que se deben convertir.	Table View
input_time_field	El campo que contiene los valores de tiempo. Puede ser de tipo corto, largo, flotante, doble, de texto o fecha.	Field
input_time_format (Opcional)	Formato en que se almacenaron los valores de tiempo en el campo de tiempo de entrada. Se puede seleccionar un formato de tiempo estándar de la lista desplegable o se puede introducir un formato personalizado. Nota: Las cadenas de caracteres del formato distinguen entre mayúsculas y minúsculas. Si el tipo de datos del campo de tiempo es fecha, no es necesario ningún formato de tiempo. Si el tipo de datos del campo de tiempo es numérico (Corto, Largo, Flotante o Doble), se proporciona una lista de formatos de tiempo numéricos estándar en la lista desplegable. Si el tipo de datos del campo de tiempo es una cadena, se proporcionará una lista de formatos de tiempo de cadena estándar en la lista desplegable. Para campos de cadena, también puede optar por especificar un formato de tiempo personalizado. Por ejemplo, los valores de tiempo pueden haberse almacenado en un campo de cadena, en uno de los formatos estándar, como por ejemplo aaaa/MM/dd HH:mm:ss o en un formato personalizado, como dd/MM/aaaa HH:mm:ss. En el formato personalizado, también puede especificar la designación de a.m., p.m. Estos son algunos de los formatos que se utilizan frecuentemente: aaaa: año, representado por cuatro dígitos. MM: mes como dígitos con ceros a la izquierda para meses de un solo dígito. MMM: mes como abreviatura de tres letras. dd: día del mes como dígitos con ceros a la izquierda para días de un solo dígito. ddd: día de la semana como abreviatura de tres letras. hh: hora con ceros a la izquierda para horas de un solo dígito; reloj de 12 horas. HH: hora con ceros a la izquierda para horas de un solo dígito; reloj de 24 horas. mm: minutos con cero a la izquierda para minutos de un solo dígito ss: segundos con cero a la izquierda para segundos de un solo dígito t: una cadena de caracteres marcadora de carácter de tiempo como, por ejemplo, A o P. tt: una cadena de caracteres marcadora de múltiples caracteres de tiempo como, por ejemplo, AM o PM. Más información sobre formatos de fecha y hora personalizados	String
output_time_field	El nombre del campo de salida en el cual se almacenarán los valores de hora convertidos.	String
output_time_type (Opcional)	El tipo de datos del campo de hora de salida. DATE —Fecha u hora TEXT —Cualquier cadena de caracteres LONG —Números enteros entre -2.147.483.648 y 2.147.483.647 SHORT —Números enteros entre -32.768 y 32.767 DOUBLE —Números fraccionarios entre -2,2E308 y 1,8E308 FLOAT —Números fraccionarios entre -3,4E38 y 1,2E38	String
output_time_format (Opcional)	El formato en el cual se guradarán los valores de hora. La lista de formatos de hora de salida depende del tipo de datos de salida especificados para el campo de hora de salida. También se puede utilizar un formato personalizado cuando el tipo de datos del campo de tiempo de salida no es Fecha. Para ver una lista de formatos personalizados, consulte la explicación de Formato de tiempo de entrada. Nota: Si el tipo de datos del campo de tiempo de salida no es lo suficientemente largo para almacenar el valor de tiempo convertido, el valor de salida se truncará.	String

Salida derivada

Nombre	Explicación	Tipo de datos
out_table

Muestra de código

Ejemplo 1 de ConvertTimeField (ventana de Python)

La siguiente secuencia de comandos de la ventana de Python muestra cómo utilizar la herramienta ConvertTimeField en el modo inmediato.

import arcpy
arcpy.ConvertTimeField_management("C:/Data/TemporalData.gdb/Input_Table","Input_Time","1033;MMMM dd, yyyy HH:mm:ss;AM;PM","Output_Time")

Ejemplo 2 de ConvertTimeFieldl (secuencia de comandos independiente)

La siguiente secuencia de comandos independiente muestra cómo utilizar la herramienta 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)

Entornos

Esta herramienta no utiliza ningún entorno de geoprocesamiento.

Información sobre licencias

• ArcGIS Desktop Basic: Sí
• ArcGIS Desktop Standard: Sí
• ArcGIS Desktop Advanced: Sí