基礎工具-節氣工具

文件說明

        通過指定的年月日，計算出當年的節氣以及具體時間。對於12節，回傳資料中，jieqi_name 最終12節表如下： '小寒','立春','驚蟄','清明','立夏','芒種','小暑','立秋','白露','寒露','立冬','大雪';
對於24節氣，回傳資料中，jieqi_name 最終24節氣表如下： '小寒', '大寒', '立春', '雨水', '驚蟄', '春分', '清明', '谷雨', '立夏', '小滿', '芒種', '夏至', '小暑', '大暑', '立秋', '處暑', '白露', '秋分', '寒露', '霜降', '立冬', '小雪', '大雪', '冬至'

請求方式

POST GET 

https://api.yuanfenju.com/index.php/v1/Gongju/jieqi

請求標頭 (Headers)

欄位 型別 描述
Content-Type String application/x-www-form-urlencoded

請求參數

欄位 型別 描述
api_key String 存取金鑰 (API Key)
type Int 曆法類型 0農曆 1公曆
year Int 年 例: 1988
month Int 月 例: 8
day Int 日 例: 7
jieqi Int 是否需要24節氣 例: 0：只展示12節 1：展示24節氣
選填，如果不傳遞這個參數，預設0

請求參數範例

$request_data = [
'api_key' => 'FsF1CsVevk3N17w7oBkSydfSk',
'type' => '1',
'year' => '1988',
'month' => '11',
'day' => '8',
];

回傳參數

欄位 型別 描述
errcode String 狀態碼 0成功 其它為失敗
errmsg String 狀態碼說明
notice String 聲明
data Json 資料內容

成功回傳範例

{
  "errcode": 0,
  "errmsg": "請求成功",
  "notice":"本次測算結果僅供娛樂使用，請勿用於封建迷信和違法用途。",
  "data": [
    {
      "jieqi_name": "小寒",               //節氣
      "jieqi_simple_time": "2024-01-06",    //公曆時間
      "jieqi_detail_time": "2024-01-06 04:49:09", //公曆詳細時間
      "jieqi_lunar_time_isleap": "0", //是否為閏月 1是 0否
      "jieqi_simple_lunar_time": "2023-11-25", //農曆時間
      "jieqi_detail_lunar_time": "2023-11-25 04:49:09" //農曆詳細時間
    },
    {
      "jieqi_name": "立春",
      "jieqi_simple_time": "2024-02-04",
      "jieqi_detail_time": "2024-02-04 16:26:53",
      "jieqi_lunar_time_isleap": "0", //是否為閏月 1是 0否
      "jieqi_simple_lunar_time": "2023-12-25",
      "jieqi_detail_lunar_time": "2023-12-25 16:26:53"
    },
    {
      "jieqi_name": "驚蟄",
      "jieqi_simple_time": "2024-03-05",
      "jieqi_detail_time": "2024-03-05 10:22:31",
      "jieqi_lunar_time_isleap": "0",
      "jieqi_simple_lunar_time": "2024-01-25",
      "jieqi_detail_lunar_time": "2024-01-25 10:22:31"
    },
    {
      "jieqi_name": "清明",
      "jieqi_simple_time": "2024-04-04",
      "jieqi_detail_time": "2024-04-04 15:02:03",
      "jieqi_lunar_time_isleap": "0",
      "jieqi_simple_lunar_time": "2024-02-26",
      "jieqi_detail_lunar_time": "2024-02-26 15:02:03"
    },
    {
      "jieqi_name": "立夏",
      "jieqi_simple_time": "2024-05-05",
      "jieqi_detail_time": "2024-05-05 08:09:51",
      "jieqi_lunar_time_isleap": "0",
      "jieqi_simple_lunar_time": "2024-03-27",
      "jieqi_detail_lunar_time": "2024-03-27 08:09:51"
    },
    {
      "jieqi_name": "芒種",
      "jieqi_simple_time": "2024-06-05",
      "jieqi_detail_time": "2024-06-05 12:09:40",
      "jieqi_simple_lunar_time": "2024-04-29",
      "jieqi_detail_lunar_time": "2024-04-29 12:09:40"
    },
    {
      "jieqi_name": "小暑",
      "jieqi_simple_time": "2024-07-06",
      "jieqi_detail_time": "2024-07-06 22:19:49",
      "jieqi_lunar_time_isleap": "0",
      "jieqi_simple_lunar_time": "2024-06-01",
      "jieqi_detail_lunar_time": "2024-06-01 22:19:49"
    },
    {
      "jieqi_name": "立秋",
      "jieqi_simple_time": "2024-08-07",
      "jieqi_detail_time": "2024-08-07 08:09:01",
      "jieqi_simple_lunar_time": "2024-07-04",
      "jieqi_detail_lunar_time": "2024-07-04 08:09:01"
    },
    {
      "jieqi_name": "白露",
      "jieqi_simple_time": "2024-09-07",
      "jieqi_detail_time": "2024-09-07 11:11:06",
      "jieqi_lunar_time_isleap": "0",
      "jieqi_simple_lunar_time": "2024-08-05",
      "jieqi_detail_lunar_time": "2024-08-05 11:11:06"
    },
    {
      "jieqi_name": "寒露",
      "jieqi_simple_time": "2024-10-08",
      "jieqi_detail_time": "2024-10-08 02:59:43",
      "jieqi_lunar_time_isleap": "0",
      "jieqi_simple_lunar_time": "2024-09-06",
      "jieqi_detail_lunar_time": "2024-09-06 02:59:43"
    },
    {
      "jieqi_name": "立冬",
      "jieqi_simple_time": "2024-11-07",
      "jieqi_detail_time": "2024-11-07 06:19:49",
      "jieqi_lunar_time_isleap": "0",
      "jieqi_simple_lunar_time": "2024-10-07",
      "jieqi_detail_lunar_time": "2024-10-07 06:19:49"
    },
    {
      "jieqi_name": "大雪",
      "jieqi_simple_time": "2024-12-06",
      "jieqi_detail_time": "2024-12-06 23:16:47",
      "jieqi_lunar_time_isleap": "0",
      "jieqi_simple_lunar_time": "2024-11-06",
      "jieqi_detail_lunar_time": "2024-11-06 23:16:47"
    }
  ]
}

失敗回傳範例

{
  "errcode": -1,
  "errmsg": "日期有誤",
}
導覽目錄