宜搭+
    正在准备搜索索引...

    类 SchoolDays

    基于学年、学期和周次等学校时间语义进行日期计算的工具类。

    SchoolDays 通过 SchoolDaysPreset 提供基准时间、基准年份、 基准学期以及固定学期开始时间等预设，支持计算指定学年的学期开始时间、 获取基准年份与基准学期。适用于课表、学期安排等学校相关场景。

    26.4.13

    Utils.DateX

    const sd = SchoolDays.of({ benchmarkYear: 2025 })
    console.log(sd.semesterStart()) // 2025-2026 学年第一学期开始时间戳
    console.log(sd.benchmarkSemester())
    索引

    方法

    benchmarkDateTime benchmarkSemester benchmarkYear semesterStart of

    方法

    • 获取当前用于计算的基准学期。

      若 SchoolDaysPreset.benchmarkSemester 已提供，则直接返回该学期； 否则根据当前基准时间是否处于第一学期开始时间与第二学期开始时间之间 进行判断：处于之间则为第一学期，否则为第二学期。

      参数

      • isInAdvance: boolean = false

        是否使用提前计算的学期开始时间，默认为 false。

      返回 1 | 2

      基准学期，1 或 2。

      26.4.13

    • 计算指定学年和学期的开始时间戳。

      若 SchoolDaysPreset.semesterStart 已提供，则直接返回该固定值； 否则基于农历正月十六与学期规则推算。第一学期默认从 9 月 1 日开始， 第二学期默认从次年农历正月十六开始；启用提前计算时，分别再提前 10 天与 15 天，并按周一对齐。

      参数

      • year: number = ...

        学年年份，例如 2025 表示 2025-2026 学年， 默认为 SchoolDays.benchmarkYear。

      • semester: 1 | 2 = ...

        学期，1 表示第一学期，2 表示第二学期， 默认为 SchoolDays.benchmarkSemester。

      • isInAdvance: boolean = false

        是否提前计算学期开始时间，默认为 false。

      返回 number

      学期开始时间的毫秒时间戳。

      26.4.13

    显示设置

    成员可见性

    目录

    方法