Skip to content

LuaTime

Representa una hora. Se obtiene al llamar a get_time() o al leer un campo Time desde un ResultSet.

Conversión a string

lua
tostring(t)  -- → "14:30:00"
"" .. t      -- → "14:30:00"

Función global

get_time()

Obtiene la hora actual.

lua
local t = get_time()

Creación

lua
local t = get_time()

-- Desde función global con hora, minuto, segundo
local almuerzo = time(12, 30, 0)

Métodos de acceso

lua
t:hour()                -- → 0-23 (int)
t:minute()              -- → 0-59 (int)
t:second()              -- → 0-59 (int)

Formato

lua
t:format()                          -- → "14:30" (según cultura de la app)
t:format("hh:mm:ss")                -- → "02:30:00" (12h)
t:format("hh:mm tt", "en-US")       -- → "02:30 PM"

El formato sigue los patrones de formato de hora de .NET.

Operaciones

lua
-- Diferencia entre horas
t:minutes_between(otra_hora)  -- → int
t:seconds_between(otra_hora)  -- → int

-- Sumar/restar unidades
t:add(90, "minutes")    -- → LuaTime (también "hours", "seconds")
t:add(-30, "seconds")

-- Redondear a un intervalo
t:round(15, "minutes")  -- → LuaTime, redondea al cuarto de hora
t:round(1, "hours")     -- → LuaTime, redondea a la hora exacta
t:round(30, "minutes", "floor")  -- → LuaTime, redondea hacia abajo
t:round(5, "seconds", "ceil")    -- → LuaTime, redondea hacia arriba

Soporta unidades: seconds, minutes, hours.

Modo de redondeo (opcional): "round" (defecto, redondeo estándar), "floor" (siempre hacia abajo), "ceil" (siempre hacia arriba).