README

简介

这是一个综合了日本节假日、六曜、干支、和历以及日本语中星期表示的日处理库。它是一个汇总了日本日期处理的包，包括日本国家节假日、六曜、农历、和历以及日本星期表示。

主要提供以下三个功能：

• 扩展PHP著名的日期处理库Carbon，增加了处理日本节假日和农历的JapaneseDate\DateTime
  • Carbon，PHP著名的日期处理库，已扩展以处理日本节假日和农历JapaneseDate \DateTime
• JapaneseDate\DateTime的不可变对象JapaneseDate\DateTimeImmutable
• 处理日期数组的JapaneseDate\Calendar
  • 与日期数组一起工作，JapaneseDate \Calendar

注意

此日期库曾以php.five-foxes.com 或ENVI的子包的形式公开，现已迁移至GitHub。

此日期库以前被称为[php.five-foxes.com] (http://php.five-foxes.com) [ENVI Subpackages] (原名为https://github.com/EnviFramework/JapaneseDate) 已迁移至GitHub。

如何使用

• 文档
• API 文档

安装说明

Composer

composer require japanese-date/japanese-date

GitHub迁移前的更新历史

• 2005年7月29日 版本 0.1

  • 初步发布

• 2005年8月1日 版本 1.0

  • 添加了调休日的判断
  • 修复了特定月份的第一天变成了下一个月的bug。
  • 春分日 * 秋分日的获取方法更改。（方法名也进行了更改。）

• 2005年9月1日 版本 1.0.1

  • 修正了源代码注释

• 2005年9月30日 版本 1.1

  • 添加了方法

• 2005年11月22日 版本 1.2

  • 删除了通知。

• 2006年3月29日 版本 1.3

  • 修改了示例
  • 修正了mb_strftime()的行为。
  • 在PHP 5中进行了测试。
  • 将常量更改为以JD_开头。
  • 稳定版

• 2006年6月19日 版本 1.4

  • 添加了农历计算。
  • 正确实现了六曜计算。

• 2006年10月5日 版本 1.5

  • 实现了工作日计算。

• 2007年8月16日 版本 1.6

  • 向mb_strftime()添加了$luna参数。
  • 添加了对使用中的$luna参数的说明。
  • 农历计算涉及月相计算，相当复杂。
  • 如果您只想进行节假日等计算而不使用农历，可以将$luna参数设置为false，从而提高速度。
  • (春分日、秋分日也使用不同的逻辑计算，因此可以将其与农历分开。)

• 2008年1月9日 版本 1.7

  • 修复了由于收到bug报告，平成天皇生日在昭和也成为休假的错误。
  • 谢谢。

• 2010年8月30日 版本 1.7

  • 修复了getSpanCalendar在$luna参数无效的问题。

• 2012年2月3日 版本 2.0

  • 重新编写以供PHP5专用。
  • 处理了山之日。

• 2016年5月13日 版本 2.1

  • 实现了GitHub化。

• 2016年5月18日 版本 3

  • 正式支持PHP5。

• 2018年5月4日 版本 4

  • 正式支持PHP7。

• 2005年7月29日 版本 0.1

• 初步发布

• 2005年8月1日 版本 1.0

• 添加了调休日的判断

• 修复了特定月份的第一天变成了下一个月的bug。

• 春分日 * 秋分日的获取方法更改。（方法名也进行了更改。）

• 2005年9月1日 版本 1.0.1

• 修改了源代码注释

• 2005年9月30日 版本 1.1

• 添加了方法

• 2005年11月22日 版本 1.2

• 删除了通知。

• 2006年3月29日 版本 1.3

• 修改了示例

• 修正了mb_strftime()的行为。

• 在PHP 5中进行了测试。

• 将常量更改为以JD_开头。

• 稳定版

• 2006年6月19日 版本 1.4

• 添加了农历计算。

• 正确实现了六曜计算。

• 2006年10月5日 版本 1.5

• 实现了工作日计算。

• 2007年8月16日 版本 1.6

• 将$luna参数添加到mb_strftime()。

• 我遗漏了$luna参数在其他地方的描述。

• 农历的计算相当复杂，因为它需要计算月相。

• 如果您不想使用农历，而只想计算节假日等，可以将$luna参数设置为false以获得更快的性能。

• （秋分日和春分日由不同的逻辑确定，因此可以从旧历中分离出来。）

• 2008年1月9日 版本1.7

• 我已经纠正了收到错误报告的平成天皇生日即使在昭和时代也关闭了的事实。

• 非常感谢。

• 2010年8月30日 版本1.7

• 修复了getSpanCalendar，因为$luna参数不起作用。

• 2012年2月3日 版本2.0

• 专门为PHP 5重写。

• 我处理了山日。

• 2016年5月13日 版本2.1

• 上传到GitHub。

• 2016年5月18日 版本3

• PHP 5正式支持

• 2018年5月4日 版本4

• PHP 7正式支持