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

Parámetros

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

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

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

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.

  • DATEEl tipo de campo será fecha. Los campos de fecha admiten valores de hora y fecha.
  • TEXTEl tipo de campo será texto. Los campos de texto admiten una cadena de caracteres.
  • LONGEl tipo de campo será largo. Los campos nuevos admiten número 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)

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

NombreExplicaciónTipo 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

Casos especiales

Información de licenciamiento

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

Temas relacionados