Skip to content
Jan Hermann edited this page Oct 19, 2026 · 1 revision

🎂

Calendar dataset and lookup utility for Czech and Slovak name days (jmeniny, meniny): namespace Timely\NameDays, Java package timely.namedays.

Finder

Base class of the finders in every language (PHP, Java, JavaScript). A subclass names its language and the names are loaded from <language>/<language>.json.

Czech

Timely\NameDays\Czech\CzechFinder (czech/, data in czech.json and czech.xml).

  • nameDay(int day, int month): Returns the name day for a specific day and month. Falls back to today's date if parameters are 0, 0.
  • Java nameDay(): Returns the name day for the current day.
  • JavaScript todayName() and getName(date): Name day for today or for a Converter.
  • The data contain all 12 months with name days and national holidays (e.g., Nový rok, Tři králové, Den vítězství, Štědrý den).

Slovak

Timely\NameDays\Slovak\SlovakFinder (slovak/, data in slovak.json and slovak.xml) with the same methods as CzechNameDayFinder.

use Timely\NameDays\Czech\CzechFinder;

(new CzechFinder())->nameDay(24, 12); // "Adam a Eva -> Štědrý den"
await Timely.CzechFinder.nameDay(24, 12);
await Timely.SlovakFinder.todayName();

See JavaScript for the module usage. Try it in the Examples (examples/namedays.html).

Clone this wiki locally