Convertir campo de tiempo (Administración de datos)

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.

Parámetros

EtiquetaExplicaciónTipo de datos
Tabla de entrada

La capa o tabla que contiene el campo que contiene los valores de hora que se deben convertir.

Table View
Campo de tiempo de entrada

El campo que contiene los valores de tiempo. Puede ser de tipo corto, largo, flotante, doble, de texto o fecha.

Field
Formato de hora de entrada
(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.
    • 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
Campo de tiempo de salida

El nombre del campo de salida en el cual se almacenarán los valores de hora convertidos.

String
Tipo de hora de salida
(Opcional)

El tipo de datos del campo de hora de salida.

  • FechaFecha u hora
  • TextoCualquier cadena de caracteres
  • Largo (entero grande)Números enteros entre -2,147,483,648 y 2,147,483,647
  • Corto (entero pequeño)Números enteros entre -32,768 y 32,767
  • Doble (precisión doble)Números fraccionarios entre -2,2E308 y 1,8E308
  • Flotante (precisión simple)Números fraccionarios entre -3,4E38 y 1,2E38
String
Formato de hora de salida
(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

EtiquetaExplicaciónTipo de datos
Tabla de entrada actualizada

La tabla de entrada actualizada.

Vista de tabla

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 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.
    • 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.

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.

  • DATEFecha u hora
  • TEXTCualquier cadena de caracteres
  • LONGNúmeros enteros entre -2,147,483,648 y 2,147,483,647
  • SHORTNúmeros enteros entre -32,768 y 32,767
  • DOUBLENúmeros fraccionarios entre -2,2E308 y 1,8E308
  • FLOATNú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

NombreExplicaciónTipo de datos
out_table

La tabla de entrada actualizada.

Vista de tabla

Muestra de código

Ejemplo 1 de ConvertTimeField (ventana de Python)

El script 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 (script independiente)

El siguiente script 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

Casos especiales

Información de licenciamiento

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

Temas relacionados