PHPackages                             webino/webino-name-day-lib - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility & Helpers](/categories/utility)
4. /
5. webino/webino-name-day-lib

ActiveLibrary[Utility & Helpers](/categories/utility)

webino/webino-name-day-lib
==========================

Name day Library

12.6kPHP

Since Feb 24Pushed 12y ago1 watchersCompare

[ Source](https://github.com/webino/WebinoNameDayLib)[ Packagist](https://packagist.org/packages/webino/webino-name-day-lib)[ RSS](/packages/webino-webino-name-day-lib/feed)WikiDiscussions develop Synced yesterday

READMEChangelogDependenciesVersions (1)Used By (0)

Webino Name Day Library
=======================

[](#webino-name-day-library)

[![Build Status](https://camo.githubusercontent.com/7c10d04b0bf65ccbde464ff5a200d1464772784ca3a9d2daafe8ee88809780bc/68747470733a2f2f7365637572652e7472617669732d63692e6f72672f776562696e6f2f576562696e6f4e616d654461794c69622e706e673f6272616e63683d6d6173746572)](http://travis-ci.org/webino/WebinoNameDayLib "Master")[![Build Status](https://camo.githubusercontent.com/a76cbee65ec02a066ba1d10191bd55497f3f23a2518f984b9dff97e144d6e22f/68747470733a2f2f7365637572652e7472617669732d63692e6f72672f776562696e6f2f576562696e6f4e616d654461794c69622e706e673f6272616e63683d646576656c6f70)](http://travis-ci.org/webino/WebinoNameDayLib "Develop")

Provides API to resolve name day. **Still under development.** (currently only Slovak)

Features
--------

[](#features)

- Today and tomorrow name day according to the date
- Reverse resolving, name day date for a name
- Holy day flag

Setup
-----

[](#setup)

Following steps are necessary to get this library working:

1. Add `"minimum-stability": "dev"` to your composer.json, because this lib is under development
2. Run `php composer.phar require webino/webino-name-day-lib:dev-develop`

Requirements
------------

[](#requirements)

- PHP 5.3

QuickStart
----------

[](#quickstart)

```
    // Create the name day service
    $locale  = 'sk_SK';
    $factory = new \WebinoNameDayLib\Factory;
    $nameDay = $factory->create($locale);

    // Get the name day
    $result = $nameDay->today();

    // Holy day logic (optional)
    if ($result->isHolyDay()) {
        $text = 'Today is';
    } else {
        $text = 'Name-day today celebrating';
    }

    // Name day of the day
    $result->getName();

    // Get tomorrow name day
    $result = $nameDay->tomorrow();

    // Get today & tomorrow name day
    $arrayOfResults = $nameDay->combo();

```

Functions
---------

[](#functions)

### The service

[](#the-service)

- `NameDayResult today($date = 'now')`
- `NameDayResult tomorrow($date = 'now')`
- `array[NameDayResult, NameDayResult] combo($date = 'now')`
- `DateTime nameDate($name)`
- `DateTime nearestNameDate($name)`

### The result

[](#the-result)

- `string getName()`
- `bool isHolyDay()`

Develop
-------

[](#develop)

**Requirements**

- Linux (recommended)
- NetBeans (optional)
- Phing
- PHPUnit

**Setup**

1. Clone this repository and run: `phing update`

    Now your development environment is set.
2. Open project in the (NetBeans) IDE

**Adding region names**

1. Look at the `\WebinoNameDayLib\Region\Sk`
2. It's best to extend `\WebinoNameDayLib\Region\AbstractNames`

**Testing**

- Run `phpunit` in the test directory
- Run `phing test` in the module directory to run the tests and code insights

    *NOTE: To run the code insights there are some tool requirements.*

Todo
----

[](#todo)

- Add Czech names
- Add other nation names
- Tests for nameDate() & nearesetNameDate()

Addendum
--------

[](#addendum)

Please, if you are interested in this library report any issues and don't hesitate to contribute.

###  Health Score

24

—

LowBetter than 31% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity19

Limited adoption so far

Community9

Small or concentrated contributor base

Maturity41

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 95.2% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/382691?v=4)[Webino](/maintainers/Webino)[@webino](https://github.com/webino)

---

Top Contributors

[![bacinsky](https://avatars.githubusercontent.com/u/3078875?v=4)](https://github.com/bacinsky "bacinsky (20 commits)")[![bartko-s](https://avatars.githubusercontent.com/u/675883?v=4)](https://github.com/bartko-s "bartko-s (1 commits)")

---

Tags

frameworklibraryv2webinowipzend

### Embed Badge

![Health badge](/badges/webino-webino-name-day-lib/health.svg)

```
[![Health](https://phpackages.com/badges/webino-webino-name-day-lib/health.svg)](https://phpackages.com/packages/webino-webino-name-day-lib)
```

###  Alternatives

[j0k3r/php-readability

Automatic article extraction from HTML

184861.9k6](/packages/j0k3r-php-readability)[mix/mix-skeleton

Full-featured development skeleton

132.1k](/packages/mix-mix-skeleton)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)