NewLife.Holiday

NewLife.Holiday - Chinese Holiday Library

Chinese holiday and adjusted-workday identification library with a built-in annual holiday database, lunar festival support and fully offline operation.

Installation

dotnet add package NewLife.Holiday

Quick start

using NewLife.Holiday;

var isHoliday = "2026-10-01".ToDateTime().IsChinaHoliday();

Guangxi March 3rd Festival:

using NewLife.Holiday;

var isHoliday = "2026-04-18".ToDateTime().IsGuangxiHoliday();

Localized holiday names

HolidayInfo.DisplayName returns the holiday name in the current UI language, while Name keeps the original Chinese source:

var info = HolidayExtensions.China.Query("2026-02-15".ToDateTime()).FirstOrDefault();
Console.WriteLine(info?.DisplayName); // Spring Festival

The word list ships 11 languages (English, Simplified Chinese, Traditional Chinese, Spanish, German, Japanese, French, Portuguese, Russian, Korean and Arabic); unsupported languages fall back to Chinese.

Logging

ChinaHoliday and GuangxiHoliday accept an ILog in the constructor. The default is a null logger, so the library stays silent unless you opt in:

using NewLife.Log;
using NewLife.Holiday;

XTrace.UseConsole();
var holiday = new ChinaHoliday(XTrace.Log);
// [ChinaHoliday]Loaded 91 holiday records from 7 embedded resources for [China].

Log messages are translated with the current log language (Localization.LogCulture, falling back to Localization.Culture).

Documentation

• Requirements document
• Feature list
• Architecture design
• Localization guide
• All languages

License

MIT License © 2002-2026 NewLife Team

GitHub | Website