soff-date

v1.2.0~1KB Core

Lightweight, 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-date

Quick 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 holidays

Colombia Holidays 2026

DateNameKeyStatus
2026-01-01Año NuevonewYear
2026-01-12Día de los Reyes MagosepiphanyShifted
2026-03-23Día de San JosésaintJosephShifted
2026-04-02Jueves SantoholyThursday
2026-04-03Viernes SantogoodFriday
2026-05-01Día del TrabajolaborDay
2026-05-18Ascensión del SeñorascensionShifted
2026-06-08Corpus ChristicorpusChristiShifted
2026-06-15Sagrado CorazónsacredHeartShifted
2026-06-29San Pedro y San PablosaintPeterPaul
2026-07-20Día de la IndependenciaindependenceDay
2026-08-07Batalla de BoyacáboyacaBattle
2026-08-17Asunción de la VirgenassumptionMaryShifted
2026-10-12Día de la RazacolumbusDay
2026-11-02Día de Todos los SantosallSaintsShifted
2026-11-16Independencia de CartagenaindependenceCartagenaShifted
2026-12-08Inmaculada ConcepciónimmaculateConception
2026-12-25Navidadchristmas

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
}