> 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.md).

# Date-Time

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

Este bloque de función no tiene entradas.

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

`Text` La fecha y hora actuales como una cadena, formateada según las opciones seleccionadas.

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

`Format` Combobox para seleccionar el formato de salida. Opciones típicas incluyen:

* Standard (YYYY-MM-DD HH:MM:SS)
* Milliseconds (YYYY-MM-DD HH:MM:SS.sss)
* Iso Format (ISO 8601)

`File Name Mode` Combobox para seleccionar un estilo amigable para nombres de archivo. Opciones incluyen:

* Standard (cadena legible por humanos)
* File Name (reemplaza caracteres como ":" y espacios para que la cadena pueda usarse como nombre de archivo o carpeta)

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

* Múltiples formatos de fecha/hora para diferentes necesidades (texto legible, marcas de tiempo de alta precisión o estándar ISO).
* Opción segura para nombres de archivo que transforma la fecha/hora en un formato apto para nombrar archivos sin procesamiento adicional.
* Operación simple sin entradas — devuelve la hora del sistema en cada evaluación.

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

1. Elige el estilo de salida deseado con el control `Format`.
2. Si planeas usar la salida como parte de un nombre de archivo (para guardar imágenes, registros o videos), selecciona `File Name Mode` para obtener una cadena segura.
3. Conecta la salida `Text` a los bloques posteriores que necesiten información temporal (para nombrar archivos, registros o anotaciones).

## 📊 Evaluación <a href="#evaluation" id="evaluation"></a>

En cada ejecución, este bloque de función lee el reloj del sistema y outputa una cadena formateada según los ajustes seleccionados en `Format` y `File Name Mode`.

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

* Usa el bloque junto con `Image Write` o `Image Logger` para guardar imágenes con un nombre de archivo con marca de tiempo. Seleccionar el modo `File Name` evitará automáticamente caracteres inválidos en nombres de archivo.
* Combínalo con `Record Video` al crear grabaciones con marca de tiempo para organizar archivos por tiempo de ejecución.
* Empáralo con `CSV Export` o `Data to JSON` para añadir una marca de tiempo legible a filas de datos o registros exportados.
* Si necesitas componentes separados de fecha/hora (año, mes, hora, etc.) para lógica condicional o visualización, considera usar `Date-Time List` cuando esté disponible para obtener elementos estructurados en lugar de una sola cadena.
* Usa `String Merge` para combinar la marca de tiempo con otro texto (por ejemplo, ID de cámara o nombre de experimento) antes de escribir archivos con `File/Folder Operations` o `Choose Folder`.

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

* Si los nombres de archivo creados con la marca de tiempo generan errores al guardar, cambia `File Name Mode` a `File Name` para eliminar o reemplazar caracteres no permitidos.
* Si necesitas mayor precisión para eventos de corta duración, selecciona el formato `Milliseconds`.
* Si los bloques posteriores esperan un formato de marca de tiempo específico, verifica que el `Format` elegido coincida con esa expectativa y ajústalo según sea necesario.