JhM.BusinessDays.Col 1.0.0

BusinessDaysCol

BusinessDaysCol is a .NET class library for calculating business days in Colombia, considering local holidays and weekends. It provides easy integration with dependency injection and supports custom configurations for workdays.

Features

• Calculate business days for a given year, month, or date range in Colombia
• Considers Colombian holidays and weekends
• Optionally treat Saturdays and Sundays as workdays
• Easy integration with .NET Dependency Injection
• Constants for month and day names in English and Spanish

Installation

Add the library to your .NET project:

dotnet add package JhM.BusinessDays.Col

Or reference the project directly if using the source code.

Runtime Support

• .NET 8.0 or higher

Registration

Register the service in your Startup.cs or Program configuration:

using JhM.BusinessDays.Col.Extensions;

// In your service configuration
services.AddBussinessDaysCol();

Then inject and use IBussinessDaysColService in your classes.

Usage Examples

using JhM.BusinessDays.Col.Abstractions;

public class MyService
{
	private readonly IBussinessDaysColService _businessDaysService;

	public MyService(IBussinessDaysColService businessDaysService)
	{
		_businessDaysService = businessDaysService;
	}

	public void PrintBusinessDays()
	{
		var days = _businessDaysService.GetBussinessDays(2026);
		foreach (var day in days)
		{
			Console.WriteLine(day);
		}
	}
}

Get business days for a specific month:

var days = _businessDaysService.GetBussinessDays(2026, 4); // April 2026

Get business days between two dates:

var days = _businessDaysService.GetBussinessDays(new DateOnly(2026, 4, 1), new DateOnly(2026, 4, 30));

Holidays examples:

Check if a specific date is a holiday in Colombia:

bool isHoliday = _businessDaysService.IsHoliday(new DateOnly(2026, 3, 24)); // Returns true if March 24, 2026 is a holiday

Business days in a month with a holiday (e.g., excluding March 24, 2026 if it's a holiday):

var marchDays = _businessDaysService.GetBussinessDays(2026, 3); // marchDays will not include 2026-03-24 if it's a holiday

License

This project is licensed under the MIT License. See the LICENSE file for details.

Sección en Español

Resumen

BusinessDaysCol es una biblioteca de clases .NET para calcular días hábiles en Colombia, considerando festivos nacionales y fines de semana. Permite integración sencilla con inyección de dependencias y configuración personalizada de días laborables.

Características

• Calcula días hábiles para un año, mes o rango de fechas en Colombia
• Considera festivos y fines de semana colombianos
• Permite tratar sábados y domingos como días laborables
• Integración fácil con Dependency Injection de .NET
• Constantes de nombres de meses y días en inglés y español

Instalación

Agrega la biblioteca a tu proyecto .NET:

dotnet add package JhM.BusinessDays.Col

O referencia el proyecto directamente si usas el código fuente.

Soporte de Ejecución

• .NET 8.0 o superior

Registro

Registra el servicio en tu configuración de servicios:

using JhM.BusinessDays.Col.Extensions;

// En la configuración de servicios
services.AddBussinessDaysCol();

Luego inyecta y usa IBussinessDaysColService en tus clases.

Ejemplos de uso

using JhM.BusinessDays.Col.Abstractions;

public class MiServicio
{
	private readonly IBussinessDaysColService _servicioDiasHabiles;

	public MiServicio(IBussinessDaysColService servicioDiasHabiles)
	{
		_servicioDiasHabiles = servicioDiasHabiles;
	}

	public void ImprimirDiasHabiles()
	{
		var dias = _servicioDiasHabiles.GetBussinessDays(2026);
		foreach (var dia in dias)
		{
			Console.WriteLine(dia);
		}
	}
}

Obtener días hábiles para un mes específico:

var dias = _servicioDiasHabiles.GetBussinessDays(2026, 4); // Abril 2026

Obtener días hábiles entre dos fechas:

var dias = _servicioDiasHabiles.GetBussinessDays(new DateOnly(2026, 4, 1), new DateOnly(2026, 4, 30));

Ejemplos de festivos:

Verificar si una fecha específica es festivo en Colombia:

bool esFestivo = _servicioDiasHabiles.IsHoliday(new DateOnly(2026, 3, 24)); // Devuelve true si el 24 de marzo de 2026 es festivo

Días hábiles en un mes con festivo (por ejemplo, excluyendo el 24 de marzo de 2026 si es festivo):

var diasMarzo = _servicioDiasHabiles.GetBussinessDays(2026, 3); // 'diasMarzo' no incluirá el 2026-03-24 si es festivo

Licencia

Este proyecto está bajo la Licencia MIT. Consulta el archivo LICENSE para más detalles.