Información litúrgica
getLiturgyInformation — celebración, rango, color, tiempo, semana del salterio y ciclo de un día.
getLiturgyInformation
getLiturgyInformation(date?: Date): Promise<LiturgyInformationOutput>Devuelve los datos del día litúrgico: qué se celebra, con qué rango y color, en qué tiempo litúrgico y qué semana del salterio corresponde. Es el método que conviene llamar primero para pintar la cabecera de un día.
| Parámetro | Tipo | Descripción |
|---|---|---|
date | Date (opcional) | Día a consultar. Por defecto, la fecha de la instancia. |
Devuelve siempre un objeto, nunca undefined. Si el calendario no se puede calcular, devuelve solo { psaltery_week: "I" }, por lo que el resto de campos son opcionales en el tipo.
Ejemplo
const info = await breviarium.getLiturgyInformation(new Date(2025, 5, 16));{
"psaltery_week": "III",
"cycle": "C",
"color": "GREEN",
"color_hex": "#70b26f",
"celebration": "Lunes de la 11ª semana del Tiempo Ordinario",
"rank": "WEEKDAY",
"seasons": ["ORDINARY_TIME"],
"precedence": "WEEKDAY_13",
"periods": ["LATE_ORDINARY_TIME"],
"calendar": {
"endOfLiturgycalSeason": "2025-11-29"
}
}Un día de memoria (11 de junio de 2025):
{
"psaltery_week": "II",
"cycle": "C",
"color": "RED",
"color_hex": "#ff5654",
"celebration": "San Bernabé, apóstol",
"rank": "MEMORIAL",
"seasons": ["ORDINARY_TIME"],
"precedence": "GENERAL_MEMORIAL_10",
"periods": ["LATE_ORDINARY_TIME"],
"calendar": { "endOfLiturgycalSeason": "2025-11-29" }
}Campos
| Campo | Tipo | Descripción |
|---|---|---|
celebration | string | Nombre de la celebración, en español. |
rank | string | Rango litúrgico. Ver valores. |
color | string | Color litúrgico. Ver colores. |
color_hex | string | Color en hexadecimal, listo para la interfaz. |
psaltery_week | "I" | "II" | "III" | "IV" | "" | Semana del salterio. |
cycle | "A" | "B" | "C" | "" | Ciclo dominical del año litúrgico. |
seasons | string[] | Tiempo(s) litúrgico(s). Ver valores. |
periods | string[] | Periodos dentro del tiempo. Ver valores. |
precedence | string | Precedencia según las Normas Universales del Año Litúrgico (p. ej. WEEKDAY_13, GENERAL_MEMORIAL_10). Útil para ordenar celebraciones. |
calendar.endOfLiturgycalSeason | string | Fecha (YYYY-MM-DD) en que termina el año litúrgico en curso. Su año indica el ciclo ferial: impar = año I, par = año II. |
La clave endOfLiturgycalSeason se escribe así en la respuesta (con esa ortografía). Úsala tal cual.
rank
| Valor | Rango |
|---|---|
SOLEMNITY | Solemnidad |
SUNDAY | Domingo |
FEAST | Fiesta |
MEMORIAL | Memoria obligatoria |
WEEKDAY | Feria |
Las memorias libres (OPTIONAL_MEMORIAL) no se devuelven: en esos días la librería toma la feria.
Colores
color | color_hex | Uso |
|---|---|---|
GREEN | #70b26f | Tiempo Ordinario |
PURPLE | #794498 | Adviento y Cuaresma |
WHITE | #bdbdbd66 | Navidad, Pascua, fiestas del Señor, de la Virgen y de santos no mártires |
RED | #ff5654 | Pasión, Pentecostés, apóstoles y mártires |
ROSE | #ff81f5 | Domingos Gaudete y Laetare |
BLUE | #00bafe | Reconocido por la librería, aunque Romcal no lo devuelve actualmente: la Inmaculada llega como WHITE |
Cualquier otro color se devuelve con el color_hex del blanco. Ojo: #bdbdbd66 es un gris semitransparente, pensado para verse sobre fondos claros.
seasons
ADVENT, CHRISTMAS_TIME, LENT, PASCHAL_TRIDUUM, EASTER_TIME, ORDINARY_TIME.
Un mismo día puede pertenecer a dos tiempos: el Domingo de Pascua devuelve ["PASCHAL_TRIDUUM", "EASTER_TIME"]. Comprueba con includes() en lugar de leer solo el primer elemento.
periods
| Valor | Periodo |
|---|---|
CHRISTMAS_OCTAVE | Octava de Navidad |
DAYS_BEFORE_EPIPHANY | Días antes de la Epifanía |
DAYS_FROM_EPIPHANY | Días desde la Epifanía |
CHRISTMAS_TO_PRESENTATION_OF_THE_LORD | De Navidad a la Presentación del Señor |
PRESENTATION_OF_THE_LORD_TO_HOLY_THURSDAY | De la Presentación al Jueves Santo |
HOLY_WEEK | Semana Santa |
EASTER_OCTAVE | Octava de Pascua |
EARLY_ORDINARY_TIME | Tiempo Ordinario antes de Cuaresma |
LATE_ORDINARY_TIME | Tiempo Ordinario después de Pentecostés |
periods puede venir vacío (por ejemplo, en Adviento) o con valores repetidos. Estos valores sirven, por ejemplo, para elegir las variantes de Completas o para decidir cuándo añadir Aleluya.