用明确 UTC 与偏移计算完整太阳时间窗
准备全部观测点与半开时间窗，选择交点定义，检查完整的六文件结果。
声明原件和每个时间窗
UTC 时间窗包含起点、不包含终点。地方时只使用您完整提供的偏移区间，不猜测历史时区。
观测点与时间窗 ID 可以重复；原数组序号和原件哈希区分身份。未知对象字段或结构损坏会拒绝整件。可识别的无效观测点／时间窗仍作为完整实体保留，有效字段为 null，原词元不删。非零数下溢与溢出不能变成合法零或伪造 JSON null。
{
"schema": "neatbo.solar-horizon.input.v1",
"observers": [
{
"id": "San Jose",
"latitude": 37.2580565,
"longitude": -121.9359228,
"heightMeters": 0,
"metersAboveGround": 0
}
],
"windows": [
{
"id": "2022-07-06 21:00 PDT context, explicitly converted UTC",
"observerOrdinal": 0,
"start": {
"utc": "2022-07-07T04:00:00Z"
},
"end": {
"utc": "2022-07-08T04:00:00Z"
},
"requests": [
{
"kind": "upper-limb",
"directions": [
"rise",
"set"
]
},
{
"kind": "civil",
"directions": [
"rise",
"set"
]
},
{
"kind": "nautical",
"directions": [
"rise",
"set"
]
},
{
"kind": "astronomical",
"directions": [
"rise",
"set"
]
}
]
}
]
}- 选择文件模式使用所选原件；文本模式仅使用完整粘贴。
- 保留有限负零词元与报告中的负零路径附表。
- 不猜测缺失的历史日期或偏移。
使用完整参数合同
输入参数均明确；固定模型、年份范围与前瞻不是隐藏调参项。地方时端点必须在实际时刻匹配所提供偏移区间，完整映射覆盖两次 370 天前瞻。
| 字段 | 类型／取值 | 含义 |
|---|---|---|
| source | file / text | 默认 file；一份原始文件或完整粘贴。 |
| format / body | json / Sun | 固定；不支持 CSV 输入或其他天体。 |
| presentation | UTC / declared-offsets | 默认 UTC；声明偏移模式必须完整覆盖时间窗及 370 天前瞻。 |
| locale | en / zh | 与全部标签、警告投影一起捕获一次。 |
| lookaheadDays | 370 | 两个方向固定 370；实际递归区间工作也收费。 |
| years | [1900,2100] | 限制全部内部探测，不截断日期。 |
| observers[] | id, latitude, longitude | 有限纬度 −90..90，有限经度不改写；默认 heightMeters=0、metersAboveGround=0。 |
| windows[] | id, observerOrdinal, start, end | 从零开始引用观测点；UTC 或地方时加明确偏移；起点小于终点。 |
| requests[] | kind, directions | 默认上缘升起与落下；支持民用、航海、天文中心阈值。显式空列表无效。 |
| offsetIntervals[] | id, startUTC, endUTC, offsetSeconds, label | 有序、不重叠的完整半开映射；label 为字符串或 null。 |
检查未知状态并保存完整结果
单独找不到一个事件不能证明极昼或极夜。两次 370 天前瞻及完整时间窗必须支持该状态；不确定时保留未知。
修改输入、来源、语言或设置时，会立即取消当前运行并清除旧结果与链接。取消后可用同一原件和参数启动新的工作线程；超出联合预算时先缩小范围。
六份物理文件总计不超过 64 MiB；完整文本与复制各不超过 64 MiB，类型化结果 128 MiB，合计 320 MiB，传输 1 GiB。任何分配必须先在原 256 MiB 共同内存预算中预留。
一次 120 秒期限包含捕获、读取、计算、编码、清理和首次发布；联合容量与浏览器验收仍未实测。
| 文件 | 完整内容 |
|---|---|
| solar-events.csv | 每个事件及每个无事件请求、原词元、搜索与完整诊断 |
| solar-report.json | 全部观测点、时间窗、请求、搜索、数值符号、警告与工作回执 |
| solar-timeline.svg | 每个时间窗、请求、事件及完整报告元数据；可见的完整同一事件消费段 |
| solar-source.json | 逐字节原件，保留原 MIME |
| settings.json | 有效参数、已提供键与捕获的语言字典；完整模型、全部搜索与消费区间、负零路径 |
| NOTICE.txt | 完整原 MIT 许可与观测守卫说明 |
成熟分辨率与完整消费区间
本计算采用固定成熟模型的单交点求根区间与 Nyquist 假设。已解析事件后，完整记录从原返回时刻到原正侧区间端点的同一事件消费区间，再继续搜索。保留原 0.1 秒数值误差条件与不足一秒成对交点排除；这不是数学证书，也不是观测精度保证。高度极值附近交点、相切与不足一秒的成对交点不在完备保证内；实际观察到的不支持或接触证据仍保留未知。
任何未解释的不足一秒区间、无法推进、不自洽求根区间或请求时间窗边界重叠仍保留未知。报告保留每次原剪枝和求根出口；CSV 搜索 JSON、时间线元数据、完整复制与报告都保留整个消费区间。settings.json 同样保存完整模型、每次原搜索与完整消费区间，并保留独立的负零路径附表。
- 检查实际负／正端点值和事件、搜索身份。
- 同时保存完整原件、设置与全部六份文件。
参考资料
- 民用晨光与日出的纠正
已公开坐标与日期背景；网页分钟值不是秒级观测。
- 极昼极夜讨论
问题的实际日期缺失；另行明确的日期属于合成补充。
- 历史偏移纠正
作者报告修正了夏令时；这不能独立证明一份 1917 年偏移表。
本分类工具使用说明
展开工具，查看操作步骤、可调选项和支持范围，再直接进入工作区。
太阳地平线时间窗搜索每个明确声明的太阳时间窗，完整保留未知、极昼极夜及无效状态与证据。
UTC 时间窗包含起点、不包含终点。地方时只使用您完整提供的偏移区间，不猜测历史时区。
操作步骤
- 选择原始 JSON 文件，或粘贴包含全部观测点与时间窗的完整文档。
- 明确 UTC 端点与所需上缘或中心曙暮光定义；使用地方时时提供完整偏移表。
- 检查每个请求、事件与搜索状态，再保存全部六份文件和完整报告。
可调选项
- 当前输入来源
- 一份原始 JSON 文件 · 粘贴 JSON
- 时间显示
- UTC；保留已提供的偏移表 · UTC 与完整声明偏移
能力与限制
- 严格 UTF-8 JSON 不超过 8 MiB；1—1,000 个观测点，1—10,000 个完整时间窗。
- 仅太阳；1900—2100 年。内部探测超出支持年份时，完整保留越界／未知状态。
- 最多 4,000,000 实际检查区间天、100,000 条事件及 100,000,000 联合星历计算；两次 370 天前瞻也计费。
- 六份物理文件总计不超过 64 MiB；完整文本与复制各不超过 64 MiB，类型化结果 128 MiB，合计 320 MiB，传输 1 GiB。任何分配必须先在原 256 MiB 共同内存预算中预留。
- 一次 120 秒期限包含捕获、读取、计算、编码、清理和首次发布；联合容量与浏览器验收仍未实测。
- 时间仅按分钟量级近似。天气、折射和实际可见地平线会改变观测到的交点。
- 本计算采用固定成熟模型的单交点求根区间与 Nyquist 假设。已解析事件后，完整记录从原返回时刻到原正侧区间端点的同一事件消费区间，再继续搜索。保留原 0.1 秒数值误差条件与不足一秒成对交点排除；这不是数学证书，也不是观测精度保证。高度极值附近交点、相切与不足一秒的成对交点不在完备保证内；实际观察到的不支持或接触证据仍保留未知。