Convertir campo de tiempo (Administración de datos)

Resumen

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

Uso

• Si el campo de la hora de entrada es un campo de texto o numérico, seleccione el formato 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, se pueden agregar formatos personalizados al parámetro Formato de tiempo de entrada.

  Más información sobre la conversión de valores de tiempo de cadena en formato de fecha

Parámetros

Cuadro de diálogo

Etiqueta	Explicación	Tipo de datos
Tabla de entrada	La capa o tabla que contiene el campo que contiene los valores de tiempo 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)	El formato de los valores de tiempo en el valor del parámetro Campo de tiempo de entrada. Se puede seleccionar un formato de tiempo estándar de la lista desplegable o se puede introducir manualmente un formato personalizado. El parámetro no es compatible 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 el designador 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ías del mes, como dígitos con ceros a la izquierda para los días de un solo dígito ddd: día de la semana, como abreviatura de tres letras hh: horas, con ceros a la izquierda para horas de un solo dígito; reloj de 12 horas HH: horas, con ceros 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 múltiples 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 del campo de tiempo de salida	El nombre del campo que se agregará, en el cual 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 valores de hora y fecha. Texto—El tipo de campo será texto. Los campos de texto admiten una cadena de caracteres. Largo (entero grande)—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 pequeño)—El tipo de campo será corto. Los campos cortos admiten números enteros entre -32,768 y 32,767. Doble (precisión doble)—El tipo de campo será doble. Los campos dobles admiten números fraccionarios entre -2.2E308 y 1.8E308. Flotante (precisión simple)—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)	El formato de los valores de hora de salida. Los formatos de hora de salida admitidos 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 para 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	La capa o tabla que contiene el campo que contiene los valores de tiempo 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)	El formato de los valores de tiempo en el valor del parámetro input_time_field. El parámetro no es compatible 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 el designador 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ías del mes, como dígitos con ceros a la izquierda para los días de un solo dígito ddd: día de la semana, como abreviatura de tres letras hh: horas, con ceros a la izquierda para horas de un solo dígito; reloj de 12 horas HH: horas, con ceros 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 múltiples 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	El nombre del campo que se agregará, en el cual 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 valores de hora y fecha. 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)	El formato de los valores de tiempo de salida. Los formatos de tiempo de salida admitidos 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 para 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

Casos especiales

Información de licenciamiento

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