> For the complete documentation index, see [llms.txt](https://docs.augelab.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.augelab.com/spanish/function-blocks/blocks-reference/input-output/data-inputs/date-time-list.md).

# Date-Time List

Este bloque de función proporciona la fecha y la hora actuales como valores textuales separados. Es útil para marcar con timestamp imágenes, vídeos, registros, o para controlar lógica basada en tiempo en tu escenario.

## 📥 Entradas <a href="#inputs" id="inputs"></a>

Este bloque de función no tiene entradas.

## 📤 Salidas <a href="#outputs" id="outputs"></a>

`Year` — Año actual como texto (por ejemplo, 2026)\
`Month` — Mes actual como texto con cero a la izquierda (por ejemplo, 01..12)\
`Day` — Día del mes como texto con cero a la izquierda (por ejemplo, 01..31)\
`Hour` — Hora actual en formato 24h como texto (por ejemplo, 00..23)\
`Minute` — Minuto actual como texto (por ejemplo, 00..59)\
`Second` — Segundo actual como texto (por ejemplo, 00..59)\
`Milliseconds` — Microsegundos/milisegundos actuales como texto (valor sub-segundo de alta resolución)

Todas las salidas son valores textuales, listos para integrarse en nombres de archivo, superposiciones (overlays) o datos registrados.

## 🕹️ Controles <a href="#controls" id="controls"></a>

`Current Date` — Etiqueta de solo lectura que muestra la fecha/hora actual para una vista previa rápida\
`See Live Time` — Área de texto en vivo que muestra el timestamp más reciente (se actualiza cuando el escenario se ejecuta)

Estos son widgets de visualización que te ayudan a verificar la hora actual de forma visual mientras el escenario está en ejecución.

## 🎨 Características <a href="#features" id="features"></a>

* Valores en tiempo real: las salidas se actualizan en cada ejecución para obtener timestamps actualizados.
* Valor sub-segundo de alta resolución: útil cuando necesitas marcas de tiempo con mayor precisión.
* Salidas en texto: fáciles de concatenar con otros bloques de texto para nombres de archivo o overlays.
* Sin configuración requerida: coloca el bloque en el flujo y usa las salidas.

## ⚙️ Mecanismo de ejecución <a href="#running-mechanism" id="running-mechanism"></a>

Cada vez que el escenario ejecuta este bloque, lee el reloj del sistema y actualiza las etiquetas mostradas y las salidas textuales listadas arriba. Esas salidas pueden ser consumidas por otros bloques para registrar timestamps, etiquetar imágenes o tomar decisiones basadas en el tiempo.

## 📝 Instrucciones de uso <a href="#usage" id="usage"></a>

1. Coloca el bloque en tu flujo de trabajo. No se requieren entradas.
2. Conecta la(s) salida(s) que necesites (por ejemplo, usa `Year`, `Month`, `Day` juntas para construir una cadena de fecha).
3. Usa otros bloques para formatear o guardar los datos con timestamp (ver Consejos y Trucos para combinaciones comunes).

## 💡 Consejos y trucos <a href="#tips-and-tricks" id="tips-and-tricks"></a>

* Para escribir la fecha/hora actual sobre una imagen para registros visuales, combina este bloque con `Write Date On Image` o `Write Text On Image`.
* Para guardar imágenes con nombres de archivo con timestamp, fusiona las salidas de fecha/hora en una cadena de nombre (usa `String Merge`) y pásala a `Image Logger` o `Image Write`.
* Para timestamp de grabaciones de vídeo, envía las salidas textuales al input `File Name` de `Record Video` para que cada grabación tenga el nombre con la hora de inicio.
* Para crear registros con timestamp (CSV o JSON), combina las salidas con `Data to JSON` o `CSV Export`.
* Para disparar acciones en momentos específicos, usa `Datetime Compare` junto con bloques lógicos (por ejemplo, `Rising Edge` o `Logic Input`) para formar comprobaciones y disparadores temporales sencillos.
* Para verificación visual rápida durante el desarrollo, previsualiza imágenes con `Show Image` después de superponer la hora usando `Write Text On Image`.

## 🛠️ Solución de problemas <a href="#troubleshooting" id="troubleshooting"></a>

* Si los timestamps aparecen incorrectos, verifica el reloj del sistema y la configuración de zona horaria de tu equipo.
* Si necesitas un formato diferente (por ejemplo, sin ceros iniciales o usando reloj de 12 horas), usa `String Operations` o `String Merge` para reformatear las salidas textuales antes de usarlas.