# 服務日資料使用注意事項

以星期為單位來描述週期性的活動，其格式定義如下(為「公共運輸旅運資料標準V2.0」之規範)：

### ServiceDay

| 欄位                 | 選填 | 優先度  | 欄位說明                |
| ------------------ | -- | ---- | ------------------- |
| `Monday`           | 否  | 3(低) | 週一 營運/服務 與否         |
| `Tuesday`          | 否  | 3    | 週二 營運/服務 與否         |
| `Wednesday`        | 否  | 3    | 週三 營運/服務 與否         |
| `Thursday`         | 否  | 3    | 週四 營運/服務 與否         |
| `Friday`           | 否  | 3    | 週五 營運/服務 與否         |
| `Saturday`         | 否  | 3    | 週六 營運/服務 與否         |
| `Sunday`           | 否  | 3    | 週日 營運/服務 與否         |
| `NationalHolidays` | 是  | 2(中) | 國定假日 營運/服務 與否       |
| `DayBeforeHoliday` | 是  | 2    | 國定假日前一天 營運/服務 與否    |
| `DayAfterHoliday`  | 是  | 2    | 國定假日後一天 營運/服務 與否    |
| `TyphoonDay`       | 是  | 1(高) | 颱風停止上班上課期間 營運/服務 與否 |

{% hint style="info" %}
國定假日 (national holidays) **不包含**週六與週日
{% endhint %}

以上可注意到有四個選填欄位，這些欄位判斷的優先度較高。以底下範例為例：

```javascript
{
    Monday: 1,
    Tuesday: 1,
    Wednesday: 1,
    Thursday: 1,
    Friday: 1,
    Saturday: 0,
    Sunday: 0,
    DayAfterHoliday: 0,
    TyphoonDay: 1
}
```

上述資料可能會碰到底下情形：

1. 星期三是國定假日後一天：由於`DayAfterHoliday`有設定為0 (優先度較`Wednesday`高)，因此當天**不** 營運/服務
2. 星期三是國定假日：由於`Wednesday`設定為1 (因為無給定`NationalHolidays`，表示不受國定假日影響)，因此當天**會** 營運/服務
3. 星期三是國定假日後一天，也恰好是颱風停止上班上課期間：由於`TyphoonDay`有設定為1 (優先度較`DayAfterHoliday`與`Wednesday`高)

   ，因此當天**會** 營運/服務


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://motc-ptx-api-documentation.gitbook.io/motc-ptx-api-documentation/api-zi-liao-shi-yong-zhu-yi-shi-xiang/serviceday.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.