# Funciones de fecha y hora DKL representa fechas y horas como **números decimales**: la parte entera es la fecha (`AAAAMMDD`) y la decimal, la hora (`.HHMMSS`). No hay zona horaria. | Fecha | Número | |---|---| | 23 de noviembre de 2023 | `20231123` | | 5 de septiembre de 2007, 20:35:23 | `20070905.203523` | Así las fechas se comparan con `<` y `>`, se guardan en columnas numéricas y se ordenan sin conversiones. | Función | Descripción | |---|---| | `ndatetime.now()` | Fecha y hora actuales del sistema. | | `ndatetime.fromstr(cadena, formato)` | Convierte una cadena de fecha en número. | | `ndatetime.tostr(fecha, formato)` | Convierte una fecha numérica en cadena con formato. | | `ndatetime.add(fecha, cantidad, intervalo)` | Suma días, semanas, meses o años. | | `ndatetime.diff(fecha1, fecha2, intervalo)` | Diferencia `fecha1 - fecha2` en días, semanas, meses o años. | | `ndatetime.year(fecha)` | Año. | | `ndatetime.month(fecha)` | Mes. | | `ndatetime.day(fecha)` | Día. | Los intervalos son `"d"` (días), `"w"` (semanas), `"m"` (meses) y `"y"` (años). Otro valor produce un error. ## ndatetime.now Sin argumentos. Devuelve la fecha y hora local del servidor como `AAAAMMDD.HHMMSS`. ```dkl ahora = ndatetime.now() hoy = trun(ahora) do print(ahora > 20260101) do print(hoy == trun(hoy)) ``` ```text 1 1 ``` (El valor exacto depende del momento de la ejecución; `trun()` se queda con la fecha.) ## ndatetime.fromstr `ndatetime.fromstr(cadena, formato)`: lee una fecha escrita como cadena y la devuelve como número. La cadena se interpreta con la cultura **invariante** (formatos ISO `aaaa-mm-dd`, `aaaa-mm-dd hh:mm:ss` o `mm/dd/aaaa`); el formato, con la sintaxis de fechas de C#, indica qué número producir (los `-` y `/` del formato se ignoran): | Formato | Resultado | |---|---| | `"yyyy-MM-dd"` o `"yyyyMMdd"` | solo la fecha | | `"yyyyMMdd.HHmmss"` | fecha y hora | Una fecha en formato `dd/MM/aaaa` (como `15/03/2024`) **no** se reconoce y produce un error; conviértala antes con `split` o use `str2dt` de `functions.dkh`. ## ndatetime.tostr `ndatetime.tostr(fecha, formato)`: escribe la fecha numérica con un formato de fecha de C# (`dd/MM/yyyy`, `dddd dd MMMM yyyy`…). Es una función de **presentación**: los nombres de días y meses salen en el idioma de la cultura configurada (invariante: inglés; con `-culture:es-MX`, español). Solo usa la parte de la fecha: la hora sale como `00:00`. ## ndatetime.add `ndatetime.add(fecha, cantidad, intervalo)`: devuelve la fecha más la cantidad de días, semanas, meses o años. La cantidad puede ser negativa. Al sumar meses o años, un día que no existe se ajusta al último del mes (31 de enero + 1 mes = 29 de febrero en año bisiesto). El resultado es solo la fecha (sin hora). ## ndatetime.diff `ndatetime.diff(fecha1, fecha2, intervalo)`: devuelve `fecha1 - fecha2`. Con `"d"` los días completos; con `"w"` las semanas (puede tener decimales); con `"m"` y `"y"` la diferencia de los números de mes o de año del calendario (no meses o años cumplidos). Si `fecha1` es anterior, el resultado es negativo. ## ndatetime.year, month y day Devuelven el año, el mes o el día de una fecha numérica (con o sin hora). ## Ejemplo completo ```dkl f = 20240229 do print(ndatetime.year(f)) do print(ndatetime.month(f)) do print(ndatetime.day(f)) do print(ndatetime.tostr(f, "yyyy-MM-dd")) do print(ndatetime.tostr(f, "dd/MM/yyyy")) do print(ndatetime.tostr(f, "dddd dd MMMM yyyy")) do print(ndatetime.add(f, 1, "d")) do print(ndatetime.add(f, 1, "m")) do print(ndatetime.add(f, 1, "y")) do print(ndatetime.add(f, 2, "w")) do print(ndatetime.add(20240131, 1, "m")) do print(ndatetime.add(f, -60, "d")) do print(ndatetime.diff(20241231, 20240101, "d")) do print(ndatetime.diff(20241231, 20240101, "m")) do print(ndatetime.diff(20241231, 20200101, "y")) do print(ndatetime.diff(20240115, 20240101, "w")) do print(ndatetime.diff(20240101, 20241231, "d")) do print(ndatetime.fromstr("2024-03-15", "yyyy-MM-dd")) do print(ndatetime.fromstr("2024-03-15 13:45:10", "yyyyMMdd.HHmmss")) do print(ndatetime.tostr(20240315.134510, "yyyy-MM-dd HH:mm")) do print(ndatetime.year(20070905.203523)) ``` ```text 2024 2 29 2024-02-29 29/02/2024 Thursday 29 February 2024 20240301 20240329 20250228 20240314 20240229 20231231 365 11 4 2 -365 20240315 20240315.134510 2024-03-15 00:00 2007 ``` ## Ejemplo: facturas vencidas ```dkl ref facturas = from.json("[{\"folio\":\"A-1\",\"fecha\":20260901},{\"folio\":\"A-2\",\"fecha\":20261015}]") hoy = 20261027 plazo = 30 for i = 0; i < list.count(facturas) { ref f = list.obj(facturas, i) vence = ndatetime.add(@@(f, "#fecha"), plazo, "d") dias = ndatetime.diff(hoy, vence, "d") if dias > 0 { do print(@@(f, "folio") + " vencida hace " + str(dias) + " días (venció " + ndatetime.tostr(vence, "dd/MM/yyyy") + ")") } else { do print(@@(f, "folio") + " vence en " + str(0 - dias) + " días") } } ``` ```text A-1 vencida hace 26 días (venció 01/10/2026) A-2 vence en 18 días ``` Para fechas como objetos `System.DateTime` (con hora completa y formatos con hora) use `str2dt`, `date_str` y relacionadas de `functions.dkh`. Vea [Bibliotecas](/es/devkron/2.0/bibliotecas/).