ISO 3166 / PHP

按国家码查询当前季节

南北半球、国旗 Emoji 与 BCP 47 多语言名称,一次查表返回。

season 项目吉祥物:Seasony(季灵),season 的项目宠物

一个函数读懂南北半球

season 用 ISO 3166-1 alpha-2 国家码判断当前季节,南半球代码表内置,跨赤道国家按人口多数所在半球计算。

同一入口还能返回中文季节名、国旗 Emoji、季节 Emoji 与 BCP 47 多语言名称;全程纯内存查表,无 IO 与状态变更。

  • 南北半球判定
  • BCP 47 多语言
  • 国旗与季节 Emoji
6框架集成
8核心能力
ISO 3166国家码标准
season 项目吉祥物:Seasony(季灵) 的 微笑 表情

季灵

一颗圆滚滚的地球精灵:左上半球是春天的新绿,右下半球是秋天的暖橙,头顶一株嫩芽,四周环绕春夏秋冬四枚徽记。

同一个月份,两个季节。

八类能力都是纯函数

输入国家码与日期,输出季节与展示文案。

国家码查季节

ISO 3166-1 alpha-2 两字母代码,大小写不敏感,无效即抛异常。

南北半球

南半球代码内置查表,跨赤道国家按人口多数判定。

季节 Emoji

花、太阳、枫叶、雪花四种图形,随国家码当前季节返回。

多语言名称

BCP 47 语言区域解析,支持 zh_CN、en_US、de_DE 等写法。

国旗 Emoji

由两字母代码生成区域指示符,大小写输入都能得到国旗。

六种框架集成

Laravel、ThinkPHP、Hyperf、Yii2、Yii3 与 webman 均有接入。

版本是这样长出来的

每个版本都对应一次真实提交与发布。

v2.1.0

原生 PHP 与吉祥物 API

新增原生 PHP 引导与 Mascot/Emoji API,修正跨赤道国家判定。

v2.0.4

半球数据校准

移除人口主在北半球的 KI 与 UM,补入 TL 与 AS,并补回归测试。

v2.0.3

CI 与测试补齐

修复 PHPStan 恒真断言错误,补齐全模块单元测试与测试报告。

v2.0.2

半球数据修复收尾

完成半球数据修复,整理已知缺陷与发布说明。

版本日志

最近的发布记录,完整列表在 GitHub Releases。

最新 v2.1.0 全部版本
v2.1.02026-09-25

新增原生 PHP 支持与吉祥物 API,修正跨赤道国家半球判定。

v2.0.42026-08-29

校准南半球代码表,移除 KI/UM,补入 TL/AS 与回归测试。

v2.0.32026-08-27

修复 CI 静态分析错误,补齐单元测试与测试报告。

v2.0.22026-08-02

半球数据修复收尾,整理已知缺陷与发布说明。

v2.0.12026-07-27

修正圭亚那 GY 被错列为南半球国家的问题。

v2.0.02026-05-17

2.0 版本发布,整理已知缺陷与发布说明。

安装与使用

先安装,再用国家码查一次季节。

PHP >= 8.0 / mbstring完整 README
安装
composer require erikwang2013/season
最小示例
use Erikwang2013\Season\CountrySeason;

$season = CountrySeason::getSeason('CN');
$zh = CountrySeason::getSeasonNameZh('AU');
$flag = CountrySeason::getCountryFlagEmoji('JP');
$name = CountrySeason::getSeasonNameLocalized('DE', 'de_DE');

季灵的十二种表情

鼠标停一停,它会换一种心情。

搜索本站

输入关键词,例如“上传”“迁移”“JWT”。