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

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

### ServiceDay

<table data-header-hidden><thead><tr><th width="233">欄位</th><th width="150">選填</th><th width="150">優先度</th><th>欄位說明</th></tr></thead><tbody><tr><td>欄位</td><td>選填</td><td>優先度</td><td>欄位說明</td></tr><tr><td><code>Monday</code></td><td>否</td><td>3(低)</td><td>週一 營運/服務 與否</td></tr><tr><td><code>Tuesday</code></td><td>否</td><td>3</td><td>週二 營運/服務 與否</td></tr><tr><td><code>Wednesday</code></td><td>否</td><td>3</td><td>週三 營運/服務 與否</td></tr><tr><td><code>Thursday</code></td><td>否</td><td>3</td><td>週四 營運/服務 與否</td></tr><tr><td><code>Friday</code></td><td>否</td><td>3</td><td>週五 營運/服務 與否</td></tr><tr><td><code>Saturday</code></td><td>否</td><td>3</td><td>週六 營運/服務 與否</td></tr><tr><td><code>Sunday</code></td><td>否</td><td>3</td><td>週日 營運/服務 與否</td></tr><tr><td><code>NationalHolidays</code></td><td>是</td><td>2(中)</td><td>國定假日 營運/服務 與否</td></tr><tr><td><code>DayBeforeHoliday</code></td><td>是</td><td>2</td><td>國定假日前一天 營運/服務 與否</td></tr><tr><td><code>DayAfterHoliday</code></td><td>是</td><td>2</td><td>國定假日後一天 營運/服務 與否</td></tr><tr><td><code>TyphoonDay</code></td><td>是</td><td>1(高)</td><td>颱風停止上班上課期間 營運/服務 與否</td></tr></tbody></table>

{% 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`高)，因此當天**會**營運/服務。