Schedule

可設定一週中的某一天或特定日期。

JSON 表示法
{
  "days": [
    enum (DayOfWeek)
  ],
  "dateRanges": [
    {
      object (DateRange)
    }
  ],
  "timeRanges": [
    {
      object (TimeOfDayRange)
    }
  ]
}
欄位
days[]

enum (DayOfWeek)

選用。要套用時間表的星期幾。

dateRanges[]

object (DateRange)

選用。要套用時間表的日期範圍。設定後,時間表只會在這些特定日期範圍內生效。如果同時設定 days 和 dateRanges,則必須同時符合這兩項條件,時間表才會生效。舉例來說,如果 days 為 [MONDAY],dateRanges 為 [2026-01-01, 2026-01-31],則時間表會在 1 月的所有星期一生效。

timeRanges[]

object (TimeOfDayRange)

選用。要套用時間表的時段範圍。設定後,排程只會在這些時間範圍內生效。

DateRange

代表日期範圍,包含頭尾。

JSON 表示法
{
  "startDate": {
    object (Date)
  },
  "endDate": {
    object (Date)
  }
}
欄位
startDate

object (Date)

這是必要旗標,範圍的開始日期 (含)。

endDate

object (Date)

這是必要旗標,範圍的結束日期 (含)。

TimeOfDayRange

代表未指定日期中兩個時間點之間的時段。例如營業時間,像是 09:00 至 17:00。

JSON 表示法
{
  "startTime": {
    object (TimeOfDay)
  },
  "endTime": {
    object (TimeOfDay)
  }
}
欄位
startTime

object (TimeOfDay)

這是必要旗標,日期範圍的開始時間 (含)。

endTime

object (TimeOfDay)

這是必要旗標,時間範圍的結束時間 (不含)。如果 endTime 早於 startTime,表示結束時間是在隔天。