soff-date
v1.2.0~1KB CoreLightweight, tree-shakeable holiday calculator with algorithmic date computation.
Live Demo
Today (2026-04-22)
Not a holiday
Next Holiday
Día del Trabajo (2026-05-01)
Installation
npm install soff-dateQuick Start
import { getHolidays, isHoliday, getNextHoliday } from 'soff-date/locales/co';
// Get all holidays for a year
const holidays = getHolidays(2026);
// → [{ date: '2026-01-01', key: 'newYear', name: 'Año Nuevo' }, ...]
// Check if today is a holiday
const today = isHoliday(new Date());
// → { date: '...', key: '...', name: '...' } or null
// Get the next upcoming holiday
const next = getNextHoliday(new Date());
// → { date: '...', key: '...', name: '...' }Available Locales
🇨🇴Colombia
soff-date/locales/co18 holidays🇺🇸USA
soff-date/locales/us10 holidays🇲🇽México
soff-date/locales/mx8 holidays🇦🇷Argentina
soff-date/locales/ar16 holidays🇧🇷Brasil
soff-date/locales/br13 holidaysColombia Holidays 2026
| Date | Name | Key | Status |
|---|---|---|---|
| 2026-01-01 | Año Nuevo | newYear | |
| 2026-01-12 | Día de los Reyes Magos | epiphany | Shifted |
| 2026-03-23 | Día de San José | saintJoseph | Shifted |
| 2026-04-02 | Jueves Santo | holyThursday | |
| 2026-04-03 | Viernes Santo | goodFriday | |
| 2026-05-01 | Día del Trabajo | laborDay | |
| 2026-05-18 | Ascensión del Señor | ascension | Shifted |
| 2026-06-08 | Corpus Christi | corpusChristi | Shifted |
| 2026-06-15 | Sagrado Corazón | sacredHeart | Shifted |
| 2026-06-29 | San Pedro y San Pablo | saintPeterPaul | |
| 2026-07-20 | Día de la Independencia | independenceDay | |
| 2026-08-07 | Batalla de Boyacá | boyacaBattle | |
| 2026-08-17 | Asunción de la Virgen | assumptionMary | Shifted |
| 2026-10-12 | Día de la Raza | columbusDay | |
| 2026-11-02 | Día de Todos los Santos | allSaints | Shifted |
| 2026-11-16 | Independencia de Cartagena | independenceCartagena | Shifted |
| 2026-12-08 | Inmaculada Concepción | immaculateConception | |
| 2026-12-25 | Navidad | christmas |
Showing 18 of 18 holidays
API Reference
Returns all holidays for a given year.
function getHolidays(year: number, options?: { lang?: HolidayNames }): Holiday[]
interface Holiday {
date: string; // ISO date: '2025-01-01'
key: string; // Identifier: 'newYear'
name: string; // Display name: 'Año Nuevo'
isShifted?: boolean; // True if moved by shift rule
}