Convertir campo de tiempo (Administración de datos)

Resumen

Transfiere valores de fecha y hora almacenados en un campo a otro campo. La herramienta se puede usar para la conversión entre diferentes tipos de campos (campos de texto, numéricos o de fecha) o para convertir los valores a un formato diferente, como dd/MM/aa HH:mm:ss a aaaa-MM-dd.

Uso

Precaución:

Esta herramienta modifica los datos de entrada. Consulte Herramientas que modifican o actualizan los datos de entrada para obtener más información y estrategias para evitar cambios de datos no deseados.

• Si el campo de tiempo de entrada es un campo de texto o numérico, seleccione el formado adecuado en el parámetro Formato de tiempo de entrada.

  Más información sobre los formatos de campos de tiempo admitidos

• Si el valor del parámetro Campo de tiempo de entrada es un campo de texto, los formatos personalizados pueden agregarse al parámetro Formato de tiempo de entrada.

  Más información sobre la conversión valores de tiempo de cadena de caracteres a un formato de fecha

Parámetros

Cuadro de diálogo

Etiqueta	Explicación	Tipo de datos
Tabla de entrada	Capa o tabla que contiene el campo que contiene los valores de hora que se convertirán.	Table View
Campo de tiempo de entrada	El campo que contiene los valores de tiempo. El campo puede ser de tipo corto, largo, flotante, doble, de texto o fecha.	Field
Formato de hora de entrada (Opcional)	Formato de los valores de tiempo del valor del parámetro Campo de tiempo de entrada. Puede elegir un formato de tiempo estándar en la lista desplegable o especificar un formato personalizado. El parámetro no se admite cuando el campo de tiempo de entrada es de tipo fecha. 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 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. o 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 cero a la izquierda para horas de un solo dígito; reloj de 12 horas HH: hora con cero a la izquierda para horas de un solo dígito; reloj de 24 horas mm: minutos con ceros a la izquierda para minutos de un solo dígito ss: segundos con ceros a la izquierda para segundos de un solo dígito t: cadena de caracteres de marcador de hora de un carácter, como A o P tt: cadena de caracteres de marcador de hora de varios caracteres, como AM o PM unix_us: hora UNIX en microsegundos unix_ms: hora UNIX en milisegundos unix_s: hora UNIX en segundos unix_hex: hora UNIX en formato hexadecimal	String
Nombre de campo de tiempo de salida	Nombre del campo que se va a agregar en el que se almacenarán los valores de hora convertidos.	String
Tipo de campo de tiempo de salida (Opcional)	Especifica el tipo de campo del campo de tiempo de salida. Fecha—El tipo de campo será fecha. Los campos de fecha admiten fecha y hora. Texto—El tipo de campo será texto. Los campos de texto admiten una cadena de caracteres. Largo (entero de 32 bits)—El tipo de campo será largo. Los campos nuevos admiten número enteros entre -2.147.483.648 y 2.147.483.647. Corto (entero de 16 bits)—El tipo de campo será corto. Los campos cortos admiten números enteros entre -32.768 y 32.767. Doble (punto flotante de 64 bits)—El tipo de campo será doble. Los campos dobles admiten números fraccionarios entre -2,2E308 y 1,8E308. Flotante (punto flotante de 32 bits)—El tipo de campo será flotante. Los campos flotantes admiten números fraccionarios entre -3,4E38 y 1,2E38.	String
Formato de hora de salida (Opcional)	Formato de los valores de tiempo de salida. Los formatos de tiempo de salida que se admiten dependen del valor del parámetro Tipo de campo de tiempo de salida. También se puede utilizar un formato personalizado para convertir el valor a un formato diferente o extraer una parte del valor (como el año). Para ver una lista de formatos personalizados, consulte la ayuda del parámetro Formato de tiempo de entrada. Este parámetro no se utiliza cuando el valor del parámetro Tipo de campo de tiempo de salida es Fecha. 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

Etiqueta	Explicación	Tipo de datos
Tabla de entrada actualizada	La tabla de entrada actualizada.	Table View

Python

arcpy.management.ConvertTimeField(in_table, input_time_field, {input_time_format}, output_time_field, {output_time_type}, {output_time_format})

Nombre	Explicación	Tipo de datos
in_table	Capa o tabla que contiene el campo que contiene los valores de hora que se convertirán.	Table View
input_time_field	El campo que contiene los valores de tiempo. El campo puede ser de tipo corto, largo, flotante, doble, de texto o fecha.	Field
input_time_format (Opcional)	Formato de los valores de tiempo del valor del parámetro input_time_field. El parámetro no se admite cuando el campo de tiempo de entrada es de tipo fecha. 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 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. o 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 cero a la izquierda para horas de un solo dígito; reloj de 12 horas HH: hora con cero a la izquierda para horas de un solo dígito; reloj de 24 horas mm: minutos con ceros a la izquierda para minutos de un solo dígito ss: segundos con ceros a la izquierda para segundos de un solo dígito t: cadena de caracteres de marcador de hora de un carácter, como A o P tt: cadena de caracteres de marcador de hora de varios caracteres, como AM o PM unix_us: hora UNIX en microsegundos unix_ms: hora UNIX en milisegundos unix_s: hora UNIX en segundos unix_hex: hora UNIX en formato hexadecimal	String
output_time_field	Nombre del campo que se va a agregar en el que se almacenarán los valores de hora convertidos.	String
output_time_type (Opcional)	Especifica el tipo de campo del campo de tiempo de salida. DATE—El tipo de campo será fecha. Los campos de fecha admiten fecha y hora. TEXT—El tipo de campo será texto. Los campos de texto admiten una cadena de caracteres. LONG—El tipo de campo será largo. Los campos nuevos admiten número enteros entre -2.147.483.648 y 2.147.483.647. SHORT—El tipo de campo será corto. Los campos cortos admiten números enteros entre -32.768 y 32.767. DOUBLE—El tipo de campo será doble. Los campos dobles admiten números fraccionarios entre -2,2E308 y 1,8E308. FLOAT—El tipo de campo será flotante. Los campos flotantes admiten números fraccionarios entre -3,4E38 y 1,2E38.	String
output_time_format (Opcional)	Formato de los valores de tiempo de salida. Los formatos de tiempo de salida que se admiten dependen del valor del parámetro output_time_type. También se puede utilizar un formato personalizado para convertir el valor a un formato diferente o extraer una parte del valor (como el año). Para ver una lista de formatos personalizados, consulte la ayuda del parámetro input_time_format. Este parámetro no se utiliza cuando el valor del parámetro output_time_type es DATE. 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	La tabla de entrada actualizada.	Table View

Muestra de código

Ejemplo 1 de ConvertTimeField (ventana de Python)

El siguiente script de la ventana de Python demuestra cómo utilizar la función ConvertTimeField de 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 (script independiente)

El siguiente script independiente muestra cómo utilizar la función 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

Espacio de trabajo actual

Información de licenciamiento

• Basic: Sí
• Standard: Sí
• Advanced: Sí