Class Calendars.Builder

java.lang.Object

io.leandev.appfuse.calendar.Calendars.Builder

Enclosing class:

Calendars

public static final class Calendars.Builder
extends Object

BusinessCalendar 建構器

Since:

4.0

Method Summary

Modifier and Type	Method	Description
BusinessCalendar	build()	建構行事曆
Calendars.Builder	clock(Clock clock)	注入時鐘（測試用；設定後 zone(ZoneId) 不再影響「今天」的判定）
Calendars.Builder	closed(LocalDate date)	特定日期停業（→ ReasonCodes.CLOSED）
Calendars.Builder	closed(LocalDate date, String reasonCode)	特定日期停業（自訂原因代碼）
Calendars.Builder	closed(LocalDate date, String reasonCode, String description)	特定日期停業（自訂原因代碼與說明）
Calendars.Builder	closedOn(DayOfWeek... days)	每週固定店休日（→ ReasonCodes.CLOSED_WEEKLY）
Calendars.Builder	leadDays(int days)	前置天數：自今天起 days 天內（不含第 days 天）不可選（→ ReasonCodes.LEAD_TIME）
Calendars.Builder	maxAdvance(int days)	最遠可選範圍：晚於今天 + days 天不可選（→ ReasonCodes.OUT_OF_RANGE）
Calendars.Builder	noPast()	過去日期不可選（早於今天 → ReasonCodes.PAST）
Calendars.Builder	open(LocalDate date)	特定日期補開（覆寫所有規則與底座——如颱風假後的補班補賣日）
Calendars.Builder	rule(Predicate<LocalDate> predicate, String reasonCode)	自訂規則：命中 predicate 的日期不可選（自訂原因代碼）
Calendars.Builder	zone(ZoneId zone)	覆寫時區（預設 Calendars.DEFAULT_ZONE；「今天」依此時區判定）

Methods inherited from class Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Details

closedOn

public Calendars.Builder closedOn(DayOfWeek... days)

每週固定店休日（→ ReasonCodes.CLOSED_WEEKLY）

noPast

public Calendars.Builder noPast()

過去日期不可選（早於今天 → ReasonCodes.PAST）

leadDays

public Calendars.Builder leadDays(int days)

前置天數：自今天起 days 天內（不含第 days 天）不可選（→ ReasonCodes.LEAD_TIME）

以日曆天計；需要「N 個工作日後」語意時，改以 BusinessCalendar.plusSelectableDays(LocalDate, long) 於應用層推算再配合 closed(LocalDate)。

maxAdvance

public Calendars.Builder maxAdvance(int days)

最遠可選範圍：晚於今天 + days 天不可選（→ ReasonCodes.OUT_OF_RANGE）

closed

public Calendars.Builder closed(LocalDate date)

特定日期停業（→ ReasonCodes.CLOSED）

closed

public Calendars.Builder closed(LocalDate date,
 String reasonCode)

特定日期停業（自訂原因代碼）

closed

public Calendars.Builder closed(LocalDate date,
 String reasonCode,
 String description)

特定日期停業（自訂原因代碼與說明）

特例覆寫優先於所有規則；同一日期後設定者覆蓋先設定者。

open

public Calendars.Builder open(LocalDate date)

特定日期補開（覆寫所有規則與底座——如颱風假後的補班補賣日）

rule

public Calendars.Builder rule(Predicate<LocalDate> predicate,
 String reasonCode)

自訂規則：命中 predicate 的日期不可選（自訂原因代碼）

zone

public Calendars.Builder zone(ZoneId zone)

覆寫時區（預設 Calendars.DEFAULT_ZONE；「今天」依此時區判定）

clock

public Calendars.Builder clock(Clock clock)

注入時鐘（測試用；設定後 zone(ZoneId) 不再影響「今天」的判定）

build

public BusinessCalendar build()

建構行事曆

Returns:

BusinessCalendar