webino/webino-name-day-lib

此包的最新版本(dev-develop)没有可用的许可证信息。

命名日库

dev-develop 2014-02-24 10:04 UTC

This package is auto-updated.

Last update: 2024-09-04 23:20:25 UTC


README

Build Status Build Status

提供解析命名日的API。 仍在开发中。(目前仅支持斯洛伐克语)

特性

  • 根据日期显示今天的和明天的命名日
  • 反向解析,为名字查找命名日日期
  • 节日标志

设置

以下步骤是使此库正常工作的必要步骤

  1. "minimum-stability": "dev" 添加到您的 composer.json 中,因为此库正在开发中

  2. 运行 php composer.phar require webino/webino-name-day-lib:dev-develop

要求

  • PHP 5.3

快速入门

    // 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();

函数

服务

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

结果

  • string getName()
  • bool isHolyDay()

开发

要求

  • Linux(推荐)
  • NetBeans(可选)
  • Phing
  • PHPUnit

设置

  1. 克隆此存储库并运行: phing update

    现在您的开发环境已设置。

  2. 在(NetBeans)IDE中打开项目

添加区域名称

  1. 查看 \WebinoNameDayLib\Region\Sk
  2. 最好扩展 \WebinoNameDayLib\Region\AbstractNames

测试

  • 在测试目录中运行 phpunit

  • 在模块目录中运行 phing test 以运行测试和代码洞察

    注意:要运行代码洞察,有一些工具要求。

待办事项

  • 添加捷克语名称
  • 添加其他国家的名称
  • 对 nameDate() & nearesetNameDate() 的测试

附录

如果您对此库感兴趣,请报告任何问题,并不要犹豫贡献。