# Fecha y hora `functions.dkh` maneja fechas como objetos `DateTime` de .NET: se obtienen con `now()` o `str2dt()`, se guardan en variables `ref` y se convierten a texto con `date_str()`. Son las fechas que también devuelven `dbr.scalar`, `cell.obj` o `row.get` para columnas `DATETIME`. | Función | Devuelve | Qué hace | |---|---|---| | `now()` | Fecha (use `ref`) | Fecha y hora actuales del servidor | | `str2dt(cadena)` | Fecha (use `ref`) | Convierte una cadena a fecha. Lee con cultura **invariante**: acepta `2026-10-23`, `2026-10-23 17:05:30`, `2026-10-23T17:05:30`, `23 Oct 2026` (meses en inglés), `10/23/2026` (mes/día/año). `31/12/2026` es error | | `date_str(fecha, formato)` | Cadena | La fecha con un formato de .NET (`yyyy-MM-dd`, `dd/MM/yyyy HH:mm`, `dddd dd MMMM yyyy`…) | > La página 1.x llamaba a esta función `datestr`; su nombre real es **`date_str`**. Internamente usa `dt2str`, que también está mapeada (`_invoke(fecha, "dt2str", formato)`), pero lo normal es llamar a `date_str`. ## Ejemplo ```dkl #include "dkli.dkh" #! program "fechas" { #include "functions.dkh" ref ahora = now() do print(length(date_str(ahora, "yyyy-MM-dd HH:mm:ss"))) ref d = str2dt("2026-10-23 17:05:30") do print(date_str(d, "yyyy-MM-dd")) do print(date_str(d, "dd/MM/yyyy HH:mm")) do print(date_str(d, "dddd dd MMMM yyyy")) ref d2 = str2dt("23 Oct 2026") do print(date_str(d2, "yyyyMMdd")) do print(_get(d, "#Year")) ref d3 = str2dt("31/12/2026") exception { do print(last_error()) do clear_exceptions() } } ``` Con la cultura invariante (servidor sin `LANG`, o `dkl fechas.dkl -hide-log`): ```text 19 2026-10-23 23/10/2026 17:05 Friday 23 October 2026 20261023 2026 {1} Error en 'str2dt. (String '31/12/2026' was not recognized as a valid DateTime.Exception has been thrown by the target of an invocation.) [fechas.dkl][Ln= 15] ``` Con `dkl fechas.dkl -hide-log -culture es-MX` la cuarta línea es `viernes 23 octubre 2026`. ## Lectura invariante, presentación con la cultura del servidor En Devkron 2.0 **leer** una fecha nunca depende del servidor: `str2dt` siempre entiende el mismo texto. **Mostrar** sí: `date_str` usa la cultura de presentación (`-culture`, la llave `culture` de `fastcgi.json`, `DEVKRON_CULTURE` o la del sistema operativo), así que los nombres de mes y día (`MMMM`, `dddd`), `tt` y los formatos cortos `d` y `G` cambian según esa cultura. Los formatos numéricos como `yyyy-MM-dd HH:mm:ss` dan lo mismo en cualquier cultura. Regla práctica: - para SQL, JSON, nombres de archivo y comparaciones use `date_str(fecha, "yyyy-MM-dd HH:mm:ss")` (o `yyyy-MM-dd`); - reserve `dddd`, `MMMM`, `tt`, `d` para lo que lee una persona; - fije la cultura en producción (`"culture": "es-MX"` en `fastcgi.json`) para no depender del sistema operativo. ## Propiedades y operaciones de la fecha La fecha es un `DateTime` de .NET; sus propiedades se leen con `_get`, con `#` para números: `_get(d, "#Year")`, `_get(d, "#Month")`, `_get(d, "#Day")`, `_get(d, "#Hour")`, `_get(d, "#DayOfYear")`. Para sumar días, rangos de mes, zonas horarias, ISO 8601 y tiempo Unix, use la biblioteca estándar [time.dkh](/es/devkron/2.0/bibliotecas/estandar/time.md). ## Errores típicos | Mensaje | Causa | Solución | |---|---|---| | `String '31/12/2026' was not recognized as a valid DateTime.` | `str2dt` con día/mes/año | Pase `yyyy-MM-dd`; si recibe `dd/MM/yyyy`, reacomódelo con `split` | | El mismo programa muestra `Friday` en un servidor y `viernes` en otro | `date_str` usa la cultura de presentación | Fije `culture` en `fastcgi.json` o use formatos numéricos | | Se imprime un número pequeño (9, 14…) en lugar de la fecha, o `date_str` falla | Se asignó la fecha sin `ref` (`x = now()` guarda el índice del objeto) | `ref ahora = now()` | [Regresar a functions.dkh](/es/devkron/2.0/bibliotecas/motor/functions/)