分享几个穆斯林礼拜小工具：

全国礼拜时间表 - 礼拜时间计算器 · 使用说明

时间仅供参考，请以当地清真寺公告为准。

一、页面总览

本系统由三个页面组成，互相联动：

页面	文件	作用
今日礼拜时间	主页，显示当天五次礼拜时间及倒计时
时间校准	`ipray.php`	详细参数设置、生成月度/全年时间表
封斋开斋时间表	`ramadan.php`	显示当月每日封斋和开斋时间

二、今日礼拜时间

打开 今日礼拜时间，页面显示以下内容：

顶部信息区

公历日期：今天的星期、年月日
农历日期：对应的中国农历月日
伊斯兰历：对应的回历年份、月份名称、月日
倒计时：实时显示距离下一次礼拜开始或结束还有多少时间，精确到秒

礼拜时间列表

按顺序显示五次礼拜：

显示名称	阿语名称
晨礼/邦布答	法吉尔 Fajr
晌礼/撇什尼	主赫尔 Dhuhr
晡礼/底盖	阿斯尔 Asr
昏礼/沙目	马格里布 Maghrib
宵礼/胡夫滩	伊沙 Isha

当前正在进行的礼拜时段会用彩色渐变高亮背景标出，一目了然。

斋月期间，列表中会额外出现两行：

封斋：晨礼前，即封斋截止时间
开斋：日落后，即可以开斋的时间

定位信息栏

页面中部显示当前使用的地点名称（如 📍 广州市天河区），右侧有一个 GPS 蓝色图标按钮。

三、首次使用：设置地点

第一次打开页面，礼拜时间不会显示，因为还没有设置位置。有两种方式设置：

方式一：GPS 自动定位（推荐）

点击页面右侧的 GPS 蓝色图标，浏览器会弹出位置权限请求，允许后系统自动获取当前坐标并解析为地名。

⚠️ GPS 定位要求网站使用 HTTPS，HTTP 下浏览器会静默拒绝。

定位成功后，地名栏会显示类似 ✅ 已更新：广州市天河区（默认配置） 的提示，随即自动加载礼拜时间。

方式二：通过时间校准页面选择城市

点击底部 时间校准 按钮 → 在弹出的校准页面中选择城市或输入坐标 → 点击 💾 保存设置 → 关闭弹窗后自动刷新。

四、时间校准

点击主页底部的金色 时间校准 按钮，会从底部弹出 ipray.php 校准面板。

这里可以调整所有影响礼拜时间的参数：

① 地理位置

快速选择城市：下拉菜单包含中国各省主要城市，选择后自动填入坐标
GPS 自动定位：点击按钮获取当前位置坐标
手动输入坐标：适合下拉菜单中没有的小城市，输入纬度、经度、自定义地名

② 算法设置

参数	说明
计算方法	选择国际通用的角度标准，默认 ISNA（北美伊斯兰协会）
晡礼计算	哈乃斐派（影子长两倍）或沙斐仪派（影子长一倍）
高纬度方法	中国大部分地区无需更改，保持默认"夜间中点法"即可
时间格式	12小时制（AM/PM）或 24小时制

③ 日出日落参数

参数	说明
日出前 N 分钟是晨礼	填入数值后，晨礼 = 日出 − N 分钟，覆盖角度计算
日落前 N 分钟是晡礼	填入数值后，晡礼 = 日落 − N 分钟，覆盖角度计算
日落后 N 分钟是昏礼	默认 5 分钟，昏礼 = 日落 + N 分钟
昏礼后 N 分钟是宵礼	填入数值后，宵礼 = 昏礼 + N 分钟，覆盖角度计算
固定晌礼时间	填入如 `13:00`，每天晌礼均使用此固定时间

礼拜时间偏移（单位：分钟）：可对每个礼拜单独加减分钟，正数=延后，负数=提前。例如晌礼偏移 +15，代表在计算结果上再推迟 15 分钟。

④ 封斋/开斋时间

参数	说明
封斋 = 日出前 N 分钟	默认 15 分钟，即日出前 15 分钟必须停止进食
开斋 = 日落后 N 分钟	默认 3 分钟，日落后 3 分钟可以开斋（不会超过昏礼时间）

⑤ 计算范围与按钮

在弹窗（embed）模式下，底部有三个按钮：

按钮	作用
💾 保存设置	将当前所有参数保存到本设备，关闭弹窗后主页自动刷新显示新时间
↺ 重置	恢复所有参数为默认值
📅 获取整月时间表	保存设置后跳转到独立的 `ipray.php` 页面，显示整月时间表

五、保存配置

配置保存采用三级优先级机制，从高到低依次是：

① URL 参数（分享链接中的 #hash）
        ↓
② 服务器配置（ 目录，按设备ID存储）
        ↓
③ 浏览器本地缓存（localStorage）

什么时候需要保存？

以下情况下，主页顶部会出现 ✔️ 保存配置 和 ❌ 忽略配置 两个按钮：

通过分享链接打开，检测到 URL 中带有配置参数
本地缓存比服务器上的配置更新（例如在时间校准中修改后还未同步到服务器）

点击"保存配置"的效果

将当前配置写入服务器（配置文件），之后：

在同一台设备上再次访问，无需任何操作，自动加载上次保存的配置
清空浏览器缓存后，服务器配置仍然有效，时间照常显示
页面跳转到干净地址（去掉 URL 中的链接参数）

点击"忽略配置"的效果

清空本地缓存，重新从服务器读取原有配置
如果服务器也没有配置，页面恢复到未设置状态

六、封斋开斋时间表

主页底部点击金色链接 封斋/开斋时间表，从底部弹出 ramadan.php。

页面内容

显示当前月份每天的封斋和开斋时间
采用左右双列布局，一屏显示整月数据
这个页面需要搭配礼拜时间设置

数据来源

直接读取主页已保存的位置和算法配置，封斋/开斋时间的计算参数（封斋提前分钟数、开斋推迟分钟数）来自时间校准中设置的值。

如果尚未设置位置，页面会显示提示并附上返回主页的链接。

七、分享功能

在独立访问 ipray.php 生成时间表后，结果区下方有三个分享按钮：

按钮	作用
🔗 生成分享链接	生成包含所有配置参数的短链接，发给他人打开后显示完全相同的时间表
📋 复制为文本	将时间表复制为纯文本（制表符分隔），可粘贴到微信、记事本等
🖼️ 分享图片时间表	将当前时间表生成为图片，可直接分享到微信等

关于分享链接

链接格式为短链（如 ipray.php?c=abc123），地址简短便于传播
他人点开链接后，会看到相同城市、相同算法参数的时间表
若他人点击 ✔️ 保存配置，该配置会保存到他们自己的设备上

八、配置优先级说明

场景	实际使用的配置
首次访问，无任何配置	无，提示设置位置
通过 GPS 定位后	默认算法参数 + GPS 坐标，自动匹配城市预设（若有）
通过时间校准保存后	服务器存储的配置（跨设备无效，仅当前设备）
通过分享链接打开	URL 参数中的配置（优先级最高）
打开分享链接后点击保存	将链接中的配置写入服务器，后续访问不再需要链接

Muslim