mixislv / name-days
Latvian Name Days
Requires
- php: ^8.4
- ext-json: *
- ext-mbstring: *
Requires (Dev)
- friendsofphp/php-cs-fixer: ^3.95
- php-coveralls/php-coveralls: ^2.9
- phpstan/phpstan: ^2.3
- phpunit/php-code-coverage: ^14.4
- phpunit/phpunit: ^13.4
Suggests
None
Provides
None
Conflicts
None
Replaces
None
README
Latvian name day calendar data. The names are taken from the Latvian State Language Center's official name day calendar.
Requirements
- PHP >= 8.4
- ext-json
- ext-mbstring
Installation
You can install name-days via Composer:
composer require "mixislv/name-days"
Or add it to your composer.json:
{
"require": {
"mixislv/name-days": "^2.1"
}
}
Data Sources
The library provides two datasets:
| Source | Description |
|---|---|
name-days-lv (default) |
Official Latvian name day calendar. |
name-days-lv-extended |
Extended list with additional name variants. |
Usage
Basic Usage
<?php require 'vendor/autoload.php'; use mixisLv\NameDays\NameDays; $nameDays = new NameDays(); // Get names for current date $names = $nameDays->getNames(); echo $names->toString(); // e.g. "Mārtiņš" // Get names for a specific date (MM-DD format) $names = $nameDays->getNames('09-29'); print_r($names->toArray()); // ['Miķelis', 'Mikus', 'Miks', 'Mihails', 'Jumis'] // Also accepts full dates (YYYY-MM-DD) - only the MM-DD part is used $names = $nameDays->getNames('2019-09-29'); echo $names->toString(); // Get the date key echo $names->key(); // '09-29'
Using the Extended Dataset
<?php use mixisLv\NameDays\NameDays; $nameDays = new NameDays('name-days-lv-extended'); $names = $nameDays->getNames('09-24'); print_r($names->toArray()); // ['Agrits', 'Agrons', 'Steidzīte', 'Steiga']
Getting Only Extended Names
getExtendedNames() returns only the names that are present in the extended dataset but not in the default dataset:
<?php use mixisLv\NameDays\NameDays; $nameDays = new NameDays(); $names = $nameDays->getExtendedNames('09-24'); print_r($names->toArray()); // ['Agrits', 'Agrons', 'Steidzīte', 'Steiga']
The method behaves the same regardless of which dataset the NameDays instance was constructed with.
Finding a Name Day by Name
<?php use mixisLv\NameDays\NameDays; $nameDays = new NameDays(); // Case-insensitive lookup $date = $nameDays->getDate('mikuss'); echo $date; // '09-29' // Include the current year $dateWithYear = $nameDays->getDate('MiKuS', true); echo $dateWithYear; // '2026-09-29' // Returns null if the name is not found $nameDays->getDate('name-not-found'); // null
The Names Object
getNames() returns an instance of mixisLv\NameDays\Names with the following methods:
| Method | Return Type | Description |
|---|---|---|
key() |
string |
Returns the date key in MM-DD format. |
toArray() |
array<int, string> |
Returns an array of names for this date. |
toString() |
string |
Returns names as a comma-separated string. |
Handling Missing Dates
If there are no name days for a given date, the library returns a placeholder:
$nameDays = new NameDays(); $names = $nameDays->getNames('02-29'); $names->toString(); // '–' $names->toArray(); // ['–']
Examples
Check out the examples directory for more usage examples.
License
This project is licensed under the MIT License - see the LICENSE file for details.