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

Parámetros

EtiquetaExplicaciónTipo 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.

  • FechaEl tipo de campo será fecha. Los campos de fecha admiten fecha y hora.
  • TextoEl 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 largos admiten números 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

EtiquetaExplicaciónTipo de datos
Tabla de entrada actualizada

La tabla de entrada actualizada.

Table View

arcpy.management.ConvertTimeField(in_table, input_time_field, {input_time_format}, output_time_field, {output_time_type}, {output_time_format})
NombreExplicaciónTipo 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.

  • DATEEl tipo de campo será fecha. Los campos de fecha admiten fecha y hora.
  • TEXTEl tipo de campo será texto. Los campos de texto admiten una cadena de caracteres.
  • LONGEl tipo de campo será largo. Los campos largos admiten números enteros entre -2.147.483.648 y 2.147.483.647.
  • SHORTEl tipo de campo será corto. Los campos cortos admiten números enteros entre -32.768 y 32.767.
  • DOUBLEEl tipo de campo será doble. Los campos dobles admiten números fraccionarios entre -2,2E308 y 1,8E308.
  • FLOATEl 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

NombreExplicaciónTipo de datos
out_table

La tabla de entrada actualizada.

Table View

Muestra de código

Ejemplo 1 de ConvertTimeField (ventana de Python)

La siguiente secuencia de comandos de la ventana de Python demuestra cómo utilizar la función ConvertTimeField en 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)

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)