Iterar tiempo (Herramientas de modelo)

Resumen

Itera el tiempo de un campo de fecha.

Más información acerca del funcionamiento de Iterar tiempo en ModelBuilder

Uso

Esta herramienta solo está disponible en ModelBuilder para su uso en modelos. La herramienta no está disponible desde el panel Geoprocesamiento ni desde Python.
La herramienta acepta entidades y tablas con un campo de fecha.
La herramienta itera y filtra las filas que corresponden a diferentes intervalos y extensiones temporales. Por ejemplo, puede iterar los datos de cada hora para la totalidad de la extensión temporal de los datos o para un subconjunto de datos. La herramienta crea diferentes fracciones de tiempo que se pueden utilizar como entrada en otras herramientas.
Use el parámetro Definición de tiempo para filtrar las filas para determinados meses o días de la semana. Por ejemplo, si iteramos los datos por semana con un valor de Intervalo de periodo de tiempo de 1 semana, al ajustar Definición de tiempo a Sábado y Domingo, cada fracción de tiempo devuelve únicamente los datos correspondientes al sábado y el domingo.

Use el parámetro Subconjunto para crear uno o varios subconjuntos de cada fracción de tiempo. La siguiente tabla muestra ejemplos de diferentes valores de Retraso del subconjunto y Duración del subconjunto, suponiendo que la fracción de tiempo vaya del 1 de enero de 2022 a las 1:00 horas (01/01/2022 01:00:00) al 2 de enero de 2022 a las 1:00 horas (02/01/2022 01:00:00). Los números de la columna Caso corresponden a los números de la imagen de debajo de la tabla.


Caso	Valor del subconjunto	Resultado
	Retraso del subconjunto: 2 horas Duración del subconjunto: 2 horas	Se devolverán datos desde las 3:00 horas (01/01/2022 00:03:00) a las 5:00 horas (01/01/2022 00:05:00).
	Retraso del subconjunto: 2 horas Duración del subconjunto: 2 horas Retraso del subconjunto: 8 horas Duración del subconjunto: 4 horas	Se devolverán datos desde las 3:00 horas (01/01/2022 00:03:00) a las 5:00 horas (01/01/2022 00:05:00) y de las 9:00 horas (01/01/2022 00:09:00) a las 13:00 horas (01/01/2022 00:13:00)
	Retraso del subconjunto: 2 horas Duración del subconjunto: ninguna	Se devolverán datos desde las 3:00 horas (01/01/2022 00:03:00) a las 1:00 horas del día siguiente (02/01/2022 00:01:00).
	Retraso del subconjunto: 2 horas Duración del subconjunto: 0 horas	Se devolverán datos desde las 3:00 horas (01/01/2022 00:03:00).

Ejemplos de subconjunto Iterar tiempo

Utilice los parámetros Hora de inicio de la iteración y Hora de finalización de la iteración para crear intervalos temporales a partir de un subconjunto temporal de los datos.
Utilice los parámetros Alinear la fecha de inicio de la iteración con los datos y Alinear la fecha de finalización de la iteración con los datos con los parámetros Hora de inicio de la iteración y Hora de finalización de la iteración para alienar el inicio y el final de la iteración con el valor de fecha y hora más cercano de los datos.

El inicio y el final de los intervalos temporales se calculan a partir de la combinación de los valores de los parámetros. La siguiente tabla muestra los resultados esperados en base a diferentes combinaciones de parámetros con el parámetro Omitir intervalos vacíos desactivado. Por ejemplo, los datos se extienden del 03/01/2022 al 31/01/2022. Con un intervalo de un día, si no se especifican los valores de los parámetros Hora de inicio de la iteración y Hora de finalización de la iteración, el primer intervalo temporal se iniciará el 03/01/2022 en función del inicio de los datos y finalizará el 01/02/2022.


Hora de inicio de la iteración	Alinear la fecha de inicio de la iteración con los datos	Hora de finalización de la iteración	Alinear la fecha de finalización de la iteración con los datos	Inicio del primer intervalo de tiempo	Fin del último intervalo de tiempo
				03/01/2022	01/02/2022
01/01/2022	Desactivado			01/01/2022	01/02/2022
01/01/2022	Activado			03/01/2022	01/02/2022
		01/02/2022	Desactivado	03/01/2022	01/02/2022
		01/02/2022	Activado	03/01/2022	31/01/2022
01/01/2022	Desactivado	01/02/2022	Desactivado	01/01/2022	01/02/2022
01/01/2022	Activado	01/02/2022	Desactivado	03/01/2022	01/02/2022
01/01/2022	Desactivado	01/02/2022	Activado	01/01/2022	31/01/2022
01/01/2022	Activado	01/02/2022	Activado	03/01/2022	31/01/2022

El parámetro Incluir inicio siempre se respeta para el primer intervalo de tiempo y el parámetro Incluir finalización siempre se respeta para el último intervalo de tiempo, independientemente de los valores de los parámetros Incluir inicio e Incluir finalización. Para cada división temporal intermedia, la inclusión o exclusión de datos se basa en los valores de los parámetros. Por ejemplo, si los datos tienen valores del 01/01/2022 al 03/01/2022, la siguiente tabla muestra el resultado del recuento esperado con un intervalo de 1 día para las iteraciones de 01/01/2022 a 03/01/2022.


Intervalo de tiempo	Recuento con ambos parámetros desactivados	Recuento solo con Incluir inicio activado	Recuento solo con Incluir final activado	Recuento con ambos parámetros activados
01/01/2022 a 02/01/2022	1	1	2 (Incluir inicio siempre se respeta para el primer intervalo de tiempo)	2
02/01/2022 a 03/01/2022	0	1	1	2
03/01/2022 a 04/01/2022	0	1	0	1

El parámetro Subconjunto respeta los ajustes de inclusión en los parámetros Incluir inicio e Incluir finalización.

Cuando se usa el mismo campo para los parámetros Hora de inicio de la iteración y Hora de finalización de la iteración, las filas con valores nulos se omitirán porque no corresponden a ninguna extensión de tiempo.

Cuando se utilizan distintos campos para los parámetros Hora de inicio de la iteración y Hora de finalización de la iteración, las filas con valores nulos se omitirán de forma predeterminada. Desactive el parámetro Omitir valores nulos para incluirlos en la iteración. En las tablas siguientes se muestra si se incluirá una fila para los intervalos de tiempo de salida del 01/01/2022 al 03/01/2022 con un intervalo de un día y el parámetro Incluir inicio activado.

Por ejemplo, en la tabla siguiente, una fila tiene un valor de campo de hora de inicio nulo y el valor del campo de tiempo de finalización es 02/01/2022:


Intervalo de tiempo	Resultado esperado
01/01/2022 a 02/01/2022	Incluido (porque hay un valor de fila nulo en el campo de inicio)
02/01/2022 a 03/01/2022	Incluido (porque el parámetro Incluir inicio está activado)
03/01/2022 a 04/01/2022	No incluido

Por ejemplo, en la tabla siguiente, una fila tiene 02/01/2022 como campo de tiempo de inicio y el valor del campo de tiempo de finalización es nulo:


Intervalo de tiempo	Resultado esperado
01/01/2022 a 02/01/2022	No incluido
02/01/2022 a 03/01/2022	Incluido (porque hay un valor de fila nulo en el campo de fin)
03/01/2022 a 04/01/2022	Incluido (porque hay un valor de fila nulo en el campo de fin)

Si una fila tiene valores nulos tanto en el campo de tiempo de inicio como en el de finalización, la fila se incluirá en cada intervalo de tiempo de salida.

Desactive el parámetro Omitir intervalos vacíos para mostrar todos los intervalos de tiempo en la salida, incluidos los que tienen un recuento de cero filas. De forma predeterminada, los segmentos vacíos se ocultarán.
Para cada iteración, la herramienta devuelve las siguientes salidas:
- Capa de salida: capa con filas seleccionadas que coinciden con los criterios de intervalos de tiempo
- Hora de inicio: hora de inicio de cada intervalo de tiempo
- Hora de finalización: hora de finalización de cada intervalo de tiempo
- Recuento: recuento de filas de cada intervalo de tiempo
Los dos parámetros de salida, Hora de inicio y Hora de finalización, se indican en formato de 24 horas. Si no se especifica una hora en los datos o en cualquier valor de parámetro, el valor límite predeterminado es 00:00:00.
Los valores de los parámetros Hora de inicio y Hora de finalización se pueden utilizar como sustitución de variables en línea para definir nombres de salida en otras herramientas. Para ello, marque el parámetro Formato de cadena de hora de salida para devolver una cadena de caracteres de fecha y hora sin caracteres especiales, como en el ejemplo siguiente.

La hora siempre se añade a las cadenas de hora de inicio y finalización. Para eliminar tiempo de esa cadena, utilice la herramienta Calcular valor y defina la expresión como "%Start Time%"[:11] + "_to_" + "%End Time%"[:11]. La salida de la herramienta Calcular valor se puede utilizar, a continuación, como sustitución de variables en línea en la salida de la herramienta Copiar entidades.

Parámetros

Dialog

Etiqueta	Explicación	Tipo de datos
Tabla de entrada	Tabla de entrada que se iterará.	Table View; Feature Layer
Definición de tiempo (Opcional)	Especifica el filtro que se aplicará a los datos. Ninguno—No se aplicará ningún filtro. Días laborables—Los datos se filtrarán utilizando el valor del parámetro Días. Meses—Los datos se filtrarán utilizando el valor del parámetro Meses.	String
Meses (Opcional)	Especifica el mes que se utilizará para filtrar los datos. Este parámetro está activo si el valor del parámetro Definición de tiempo es Meses. Enero—Se devolverán los datos de enero. Febrero—Se devolverán los datos de febrero. Marzo—Se devolverán los datos de marzo. Abril—Se devolverán los datos de abril. Mayo—Se devolverán los datos de mayo. Junio—Se devolverán los datos de junio. Julio—Se devolverán los datos de julio. Agosto—Se devolverán los datos de agosto. Septiembre—Se devolverán los datos de septiembre. Octubre—Se devolverán los datos de octubre. Noviembre—Se devolverán los datos de noviembre. Diciembre—Se devolverán los datos de diciembre.	String
Días (Opcional)	Especifica el día de la semana que se usará para filtrar los datos. Este parámetro está activo si el valor del parámetro Definición de tiempo es Días. Lunes—Se devolverán los datos del lunes. Martes—Se devolverán los datos del martes. Miércoles—Se devolverán los datos del miércoles. Jueves—Se devolverán los datos del jueves. Viernes—Se devolverán los datos del viernes. Sábado—Se devolverán los datos del sábado. Domingo—Se devolverán los datos del domingo.	String
Intervalo de periodo de tiempo	Intervalo temporal que se utilizará para crear fracciones de tiempo. Solo son válidos los números enteros.	Time Unit
Subconjunto (Opcional)	Uno o más subconjuntos temporales para cada iteración. Cada subconjunto se define por un par de valores de Retraso del subconjunto y Duración del subconjunto. El inicio de cada intervalo de tiempo está desplazado por el valor de Retraso del subconjunto, y el rango temporal del intervalo se define por el valor Duración del subconjunto. Por ejemplo, un intervalo de tiempo se da entre el 1 de enero de 2022 a las 1:00 horas (01/01/2022 01:00:00) y el 2 de enero de 2022 a las 1:00 horas (02/01/2022 01:00:00), con un valor de Retraso del subconjunto de 2 horas. Cuando el valor de Duración del subconjunto sea de 2 horas, el intervalo de tiempo empezará a las 3:00 horas (01/01/2022 00:03:00) y finalizará a las 5:00 horas (01/01/2022 00:05:00). Cuando el valor de Duración del subconjunto esté vacío, el intervalo de tiempo empezará a las 3:00 horas (01/01/2022 00:03:00) y finalizará a la 1:00 hora del día siguiente (02/01/2022 01:00:00). Cuando el valor de Duración del subconjunto sea 0, el subconjunto solo devolverá los datos de las 3:00 horas (01/01/2022 00:03:00). Columnas de la tabla de valores: Subset Delay—The offset from the start of each temporal slice. Subset Duration—The temporal range of the slice.	Value Table
Campo de tiempo de inicio	Campo que se utilizará para definir la extensión temporal (o su principio) y la consulta para crear fracciones de tiempo. Este campo puede ser de tipo Fecha o Solo fecha, o Solo hora en función de la unidad de tiempo utilizada para iterar en el conjunto de datos. La extensión temporal se puede alterar especificando un valor de fecha y hora diferente para el parámetro Hora de inicio de la iteración.	Field
Campo de tiempo de fin (Opcional)	Campo que se utilizará para definir el final de la extensión temporal y la consulta para crear fracciones de tiempo. El tipo de este campo debe coincidir con el tipo de campo del valor del parámetro Campo de tiempo de inicio. Este campo se puede agregar si los datos tienen campos de fecha independientes para las horas de inicio y fin. Si los datos tienen un campo único para las horas de inicio y finalización, deje este parámetro en blanco o defínalo en el mismo campo que el valor de Campo de tiempo de inicio.	Field
Hora de inicio de la iteración (Opcional)	Una hora de inicio que crea un subconjunto de los datos que comienzan en la hora, fecha o fecha y hora especificadas y después de ellas. El valor debe coincidir con el tipo de campo establecido en el parámetro Campo de tiempo de inicio.	Date
Alinear la fecha de inicio de la iteración con los datos (Opcional)	Especifica si el inicio de la iteración se alineará con la fecha más cercana de los datos. Checked—El inicio de la iteración se alineará con la fecha más próxima de los datos que sea igual o posterior a la fecha especificada para el parámetro Hora de inicio de la iteración. Por ejemplo, si el valor del parámetro Hora de inicio de la iteración es 01/01/2022 y los datos comienzan a partir del 06/01/2022, la iteración empezará a partir del 06/01/2022 y dividirá los datos entre el intervalo de tiempo definido por el parámetro Intervalo de periodo de tiempo. En el caso de un intervalo de tiempo de un mes, la división será de 06/01/2022 a 06/02/2022, y así sucesivamente. Unchecked—El inicio de la iteración se alineará con la fecha especificada para el parámetro Hora de inicio de la iteración. Esta es la opción predeterminada. Por ejemplo, si el valor del parámetro Hora de inicio de la iteración es 01/01/2022 y los datos comienzan a partir del 06/01/2022, la iteración seguirá empezando a partir del 01/01/2022 y dividirá los datos por el intervalo de tiempo definido por el parámetro Intervalo de periodo de tiempo. En el caso de un intervalo de tiempo de un mes, la división será de 01/01/2022 a 01/02/2022, y así sucesivamente.	Boolean
Hora de finalización de la iteración (Opcional)	La hora de finalización que crea un subconjunto de los datos que terminan a la hora, fecha o fecha y hora especificadas o antes de ellas. El valor debe coincidir con el tipo de campo establecido en el parámetro Campo de tiempo de fin.	Date
Alinear la fecha de finalización de la iteración con los datos (Opcional)	Especifica si el final de la iteración se alineará con la fecha más cercana en los datos. Checked—El final de la iteración se alineará con la fecha más próxima de los datos que sea igual o anterior a la fecha especificada para el parámetro Hora de finalización de la iteración. Por ejemplo, si el valor del parámetro Hora de finalización de la iteración es el 31/12/2022 y los datos terminan el 28/12/2022, la iteración finalizará el 28/12/2022. El último intervalo puede ser inferior al intervalo de tiempo definido. Unchecked—El final de la iteración se alineará con la fecha más próxima especificada para el parámetro Hora de finalización de la iteración. Esta es la opción predeterminada. Por ejemplo, si el valor del parámetro Hora de finalización de la iteración es el 31/12/2022 y los datos terminan el 28/12/2022, la iteración finalizará el 31/12/2022. La última fracción se dividirá de acuerdo con el intervalo de tiempo, pero finalizará según el valor especificado en Hora de finalización de iteración.	Boolean
Incluir inicio (Opcional)	Especifica si la hora de inicio se incluirá en cada intervalo de tiempo. Checked—La hora de inicio se incluirá en cada intervalo de tiempo. Esta es la opción predeterminada. Unchecked—La hora de inicio no se incluirá en cada intervalo de tiempo.	Boolean
Incluir fin (Opcional)	Especifica si la hora de finalización se incluirá en cada intervalo de tiempo. Si se activa tanto Incluir inicio como Incluir finalización, el mismo evento se contará dos veces. Si se produjo un evento al final del intervalo anterior, también se contará en el siguiente intervalo (incluir inicio). Esto puede resultar útil en eventos continuos. Por ejemplo, un incendio lleva ardiendo tres días y se desea conocer el número total de registros de incendios nuevos y existentes Checked—Se incluirán los valores anteriores o iguales a la hora de finalización. Unchecked—Se incluirán los valores anteriores a la hora de finalización. Esta es la opción predeterminada.	Boolean
Omitir valores nulos (Opcional)	Especifica si se incluirán las filas con valores de fecha y hora nulos. Este parámetro está disponible cuando los parámetros Campo de tiempo de inicio y Campo de tiempo de finalización tengan campos de fecha diferentes. Checked—No se incluirán las filas con valores de fecha y hora nulos. Esta es la opción predeterminada. Unchecked—Se incluirán las filas con valores de fecha y hora nulos. Desactive este parámetro en los siguientes casos: The El valor del parámetro Campo de tiempo de inicio es nulo: cualquier fila con un valor nulo en el valor del parámetro Campo de tiempo de inicio se incluirá en cada intervalo de tiempo que finalice antes del valor del parámetro Campo de finalización o en ese momento. The El valor del parámetro Campo de tiempo de finalización es nulo: cualquier fila con un valor nulo en el valor del parámetro Campo de tiempo de finalización se incluirá en cada intervalo de tiempo que comience después del valor del parámetro Campo de inicio o en ese momento. Both the Los valores de los parámetros Campo de tiempo de inicio y Campo de tiempo de finalización son nulos: cualquier fila con un valores nulos en los valores de los parámetros Campo de inicio y Campo de finalización se incluirá en cada intervalo de tiempo.	Boolean
Formato de cadena de hora de salida (Opcional)	Especifica si se eliminarán caracteres reservados de los valores de los parámetros Hora de inicio y Hora de finalización de salida. Solo se conservarán los caracteres alfanuméricos y los guiones bajos. Checked—Se eliminarán los caracteres reservados de los valores de los parámetros Hora de inicio y Hora de finalización de salida. Por ejemplo, si el valor de fecha y hora es 01/01/2022 08:30:00, la cadena de caracteres con formato será 01_01_2022_00_00_00_00. Unchecked—Se eliminarán los caracteres reservados de los valores de los parámetros Hora de inicio y Hora de finalización de salida. Esta es la opción predeterminada.	Boolean
Omitir intervalos vacíos (Opcional)	Especifica si se eliminarán las fracciones de tiempo vacías. Un intervalo de tiempo vacío no contiene filas. Checked—Se eliminarán los intervalos de tiempo vacíos. Por ejemplo, los datos de entrada no tienen registros para 02/01/2022 y 03/01/2022. Con un intervalo de un día desde el 01/01/2022 hasta el 05/01/2022, esta opción omitirá estas dos fracciones de tiempo vacías y no se devolverá ninguna capa vacía. Esta es la opción predeterminada. Unchecked—No se eliminarán los intervalos de tiempo vacíos. Por ejemplo, los datos de entrada no tienen registros para 02/01/2022 y 03/01/2022. Con un intervalo de un día desde el 01/01/2022 hasta el 05/01/2022, esta opción mantendrá estos dos intervalos de tiempo y se devolverán capas vacías.	Boolean

Salida derivada

Etiqueta	Explicación	Tipo de datos
Capa de tiempo de salida	Capa con filas seleccionadas que coinciden con los criterios del intervalo de tiempo.	Any Value
Hora de inicio	La hora de inicio de cada fracción de tiempo.	String
Hora de finalización	Hora de finalización de cada intervalo.	String
Recuento	El número de filas de cada fracción.	Long

Entornos

Esta herramienta no utiliza ningún entorno de geoprocesamiento.

Información de licenciamiento

Basic: Sí
Standard: Sí
Avanzado: Sí