API Thời gian mặt trời thực
Đồng hồ trên tường và mặt trời trên nơi sinh là hai thời gian khác nhau, và trong một múi giờ rộng chúng cách nhau hàng giờ. Endpoint này trả về thời gian thứ hai, được phân tách để bạn thấy mỗi phút đến từ đâu.
API Thời gian mặt trời thực
Thời gian mặt trời thực là góc giờ của Mặt Trời hiện tượng tại kinh độ sinh, được quay nửa ngày, lấy từ Swiss Ephemeris độ lên đúng của Mặt Trời so với thời gian sao trung bình Greenwich. Nó phân tách thành hai thành phần được báo riêng. Thành phần trung tâm là khoảng cách của nơi sinh so với trung tâm múi giờ của nó, bốn phút mỗi độ, và đây là thành phần lớn: Trung Quốc có một độ lệch từ Kashgar tới Harbin, vì vậy một sinh ở Tân Cương gần ba giờ so với đồng hồ của mình. Phương trình thời gian là dao động hàng năm của Mặt Trời, lên tới khoảng mười sáu phút cả hai phía, và thường bị các bảng lịch bỏ qua. Phản hồi cũng báo liệu sự chỉnh sửa có vượt qua nửa đêm không, vì điều đó di chuyển trụ ngày chứ không chỉ giờ.
POST/v1/chinese/true-solar-time
curl -X POST https://api.astroway.info/v1/chinese/true-solar-time \
-H "X-Api-Key: aw_live_..." \
-H "Content-Type: application/json" \
-d '{
"date": "1990-05-15",
"time": "14:30:00",
"timezoneOffset": 8,
"longitude": 87.6
}'{
"ok": true,
"data": {
"clockTime": "14:30:00",
"trueSolarTime": "12:24:06",
"totalCorrectionMinutes": -125.89,
"longitudeCorrectionMinutes": -129.6,
"equationOfTimeMinutes": 3.71,
"dayShift": 0,
"date": "1990-05-15"
}
}Parameters
| name | type | Required | |
|---|---|---|---|
| date | string (YYYY-MM-DD) | yes | Local calendar date at birth. |
| time | string (HH:MM:SS) | yes | Local clock time at birth. |
| timezoneOffset | number (hours) | yes | The offset the clock was actually running on. A 1988 Beijing birth ran on +9 under summer time, and no arithmetic here recovers that from the date. |
| longitude | number | yes | Birth longitude in decimal degrees, east positive. |
When to use it
Sử dụng nó bất cứ khi nào biểu đồ phụ thuộc vào giờ đôi và nơi sinh cách xa trung tâm múi giờ: trụ giờ BaZi, cung giờ Zi Wei, bất kỳ đọc tử vi Trung Quốc nào cho sinh ở Tây Trung Quốc, trong một múi giờ rộng như Tây Ban Nha hay Argentina, hoặc bất cứ nơi nào ranh giới múi giờ thời kỳ thực dân lệch xa trung tâm. Nó cũng có thể dùng độc lập như công cụ cho công việc đồng hồ mặt trời và cho bất kỳ ai muốn đối chiếu lịch in với thời gian đồng hồ. Trong BaZi của chúng mình, cùng một chỉnh sửa có sẵn dưới dạng cờ trueSolarTime, vì vậy bạn hiếm khi cần gọi endpoint này rồi gửi lại kết quả.
Notes
Việc chỉnh sửa ảnh hưởng tới ngày và giờ và cố ý không ảnh hưởng tới năm và tháng. Li Chun và 節 là những thời điểm toàn cầu, và một đọc đồng hồ mặt trời không nói gì về lúc Mặt Trời qua 315 độ. Áp dụng chỉnh sửa vào ranh giới năm là một lỗi thực tế và phổ biến: nó cho một sinh sau Li Chun năm trước 17 phút và bốn trụ sai. Phương trình thời gian được gắn vào bốn điểm chuyển đổi đã công bố của đường cong hàng năm và bốn điểm zero của nó.
Try the Thời gian mặt trời thực API
Grab a key and make your first call in under a minute.