共用方式為

工作天 （獨立發行者） （預覽版）

工作日服務。 它涵蓋超過 45 個國家和 230 個地區日曆。 它還涵蓋主要證券交易所日曆。 數據的質量是重中之重。 API 通過關注有關公共假期變化的政府公告來提供最新信息。

此連接器適用於以下產品和區域：

服務 Class Regions
副駕駛工作室 進階 除下列區域外的所有 Power Automate 區域 ：
     - 美國政府 （GCC）
     - 美國政府（海灣合作委員會高中）
     - 由 21Vianet 營運的中國雲
     - 美國國防部 （DoD）
邏輯應用程式 標準 所有 Logic Apps 區域， 但下列區域除外：
     - Azure Government 區域
     - Azure 中國區域
     - 美國國防部 （DoD）
Power Apps 進階 除下列區域外的所有 Power Apps 區域 ：
     - 美國政府 （GCC）
     - 美國政府（海灣合作委員會高中）
     - 由 21Vianet 營運的中國雲
     - 美國國防部 （DoD）
Power Automate（自動化服務） 進階 除下列區域外的所有 Power Automate 區域 ：
     - 美國政府 （GCC）
     - 美國政府（海灣合作委員會高中）
     - 由 21Vianet 營運的中國雲
     - 美國國防部 （DoD）
連絡人​​
名稱 托馬斯·波西泰克
URL https://aka.ms/poszytek
Email tomasz@poszytek.eu
連接器中繼資料
Publisher 托馬斯·波西泰克
網站 https://api.workingdays.org/
隱私策略 https://api.workingdays.org/1.2/privacy_policy.php
類別 財政;商

正在建立連線

連接器支援下列驗證類型：
預設值 建立連線的參數。 所有區域 不可共享

預設

適用：所有地區

建立連線的參數。

這不是可共用的連線。 如果 Power App 與其他使用者共用，系統會明確提示其他使用者建立新連線。

名稱 類型 Description 為必填項目
提供您的 API 金鑰。 securestring 提供您的 API 金鑰。 對

節流限制

名稱 呼叫 續約期間
每個連線的 API 呼叫 100 60 秒

動作

Analyze

分析期間（在指定日曆上提供start_date和end_date，API 會回應期間分析）。
列出非工作日

列出 2 個日期之間的非工作日（週末、公共假期和自訂日期）。
尋找郵寄地址

有時可能需要識別哪個行事曆設定與指定客戶的郵寄地址相關。 此服務會傳回給定郵政地址的適當country_code和配置。
新增公共假期

將公共假期的日期添加到給定日期。
新增工作天數

在日期中新增 （或移除） 任意工作天數。
新增工作時間

將工作時間添加到給定的開始日期/時間。
新增週末

將週末天數新增至指定日期。
檢查配額

檢查當月內使用和下個月可用的剩餘天數配額。
獲取日期資訊

取得特定日期的詳細資訊。

Analyze

作業識別碼：
Analyze

分析期間（在指定日曆上提供start_date和end_date，API 會回應期間分析）。

參數

名稱 機碼 必要 類型 Description
國家代碼
 country_code True string

ISO 國家代碼（2 個字母）。
開始日期
 start_date True string

開始日期（YYYY-MM-DD）
結束日期
 end_date True string

結束日期（YYYY-MM-DD）
開始時間
 start_time string

開始時間 （HH：MM）
結束時間
 end_time string

結束時間 （HH：MM）
設定
 configuration string

區域預設組態的名稱。 如需詳細資訊，請參閱文件。
週末
 weekend string

你的週末結構。 週日-週一-週二-週三-週四-週五-週六。 如果您的週末是週日和週一，您可以發送：1100000如果週末是週六下午和週日：1000003
週時間
 week_times string

您的一周工作時間表結構。 此參數在計算一段時間內的工作時數時很有用。 使用時，此參數會覆寫week_hours參數。
開始範本
 start_template string

交替週範本的開始日期 （YYYY-MM-DD）如果您定義交替週範本排程，則必須知道範本從哪個星期日開始。
使用自訂設定
 use_custom_configuration boolean

考慮您自己的個人配置。
設定檔ID
 profile_id string

如果您在自訂設定下建立數個設定檔，則要使用的設定檔ID。 6 個字符。

傳回

名稱 路徑 類型 Description
end_date
 result.end_date string

結束日期
全部
 result.days.total string

期間內的總天數
所有星期一
 result.days.mondays string

期間內的星期一
所有星期二
 result.days.tuesdays string

期間內的星期二
所有星期三
 result.days.wednesdays string

期間內的星期三
所有星期四
 result.days.thursdays string

期間內的星期四
所有星期五
 result.days.fridays string

期間內的星期五
所有星期六
 result.days.saturdays string

期間內的星期六
所有週日
 result.days.sundays string

期間內的星期日
所有時間
 result.days.hours string

期間內的小時數
所有工作總計
 result.working_days.total string

期間內總工作天數
所有工作星期一
 result.working_days.mondays string

期間內的星期一工作
所有工作星期二
 result.working_days.tuesdays string

期間內的星期二工作
所有工作週三
 result.working_days.wednesdays string

期間內的星期三工作
所有工作週四
 result.working_days.thursdays string

期間內的星期四工作
所有工作週五
 result.working_days.fridays string

期間內的星期五工作
所有工作星期六
 result.working_days.saturdays string

期間內的週六工作
所有工作週日
 result.working_days.sundays string

期間內的週日工作
所有工作時間
 result.working_days.work_hours string

期間內工作時間
所有工資
 result.working_days.wages string

期間內工資
週末總天數
 result.weekend_days.total string

期間內的週末總天數
週一所有週末
 result.weekend_days.mondays string

期間內週一的週末
週二的所有週末
 result.weekend_days.tuesdays string

期間內週二的週末
週三所有週末
 result.weekend_days.wednesdays string

期間內週三的週末
週四的所有週末
 result.weekend_days.thursdays string

期間內週四的週末
週五的所有週末
 result.weekend_days.fridays string

期間內週五的週末
週六的所有週末
 result.weekend_days.saturdays string

期間內週六的週末
週日的所有週末
 result.weekend_days.sundays string

期間內週日的週末
公眾假期
 result.public_holidays object

公眾假期列表

列出非工作日

作業識別碼：
ListNonWorkingDays

列出 2 個日期之間的非工作日（週末、公共假期和自訂日期）。

參數

名稱 機碼 必要 類型 Description
國家代碼
 country_code True string

ISO 國家代碼（2 個字母）。
開始日期
 start_date True string

開始日期（YYYY-MM-DD）
結束日期
 end_date True string

結束日期（YYYY-MM-DD）
設定
 configuration string

區域預設組態的名稱。 如需詳細資訊，請參閱文件。
週末
 weekend string

你的週末結構。 週日-週一-週二-週三-週四-週五-週六。 如果您的週末是週日和週一，您可以發送：1100000如果週末是週六下午和週日：1000003
使用自訂設定
 use_custom_configuration boolean

考慮您自己的個人配置。
設定檔ID
 profile_id string

如果您在自訂設定下建立數個設定檔，則要使用的設定檔ID。 6 個字符。

傳回

名稱 路徑 類型 Description
非工作日
 result.non_working_days object

非工作日列表。

尋找郵寄地址

作業識別碼：
AddressToConfiguration

有時可能需要識別哪個行事曆設定與指定客戶的郵寄地址相關。 此服務會傳回給定郵政地址的適當country_code和配置。

參數

名稱 機碼 必要 類型 Description
Address
 address True string

郵寄地址。 它是沒有約束的字串。

傳回

名稱 路徑 類型 Description
地位
 result.status string

地址狀態
國家代碼
 result.country_code string

ISO 國家代碼。
設定
 result.configuration string

地址附加信息。
格式化地址
 result.formatted_address string

傳回格式化的地址。

新增公共假期

作業識別碼：
AddPublicHolidays

將公共假期的日期添加到給定日期。

參數

名稱 機碼 必要 類型 Description
國家代碼
 country_code True string

ISO 國家代碼（2 個字母）。
開始日期
 start_date True string

開始日期（YYYY-MM-DD）
增量
 increment True string

您要新增至開始日期的公共假日天數（正或負整數，但不是零）。
包括開始
 include_start True boolean

計數是否應該包括start_date？ 預設值為 True。
設定
 configuration string

區域預設組態的名稱。 如需詳細資訊，請參閱文件。
週末
 weekend string

你的週末結構。 週日-週一-週二-週三-週四-週五-週六。 如果您的週末是週日和週一，您可以發送：1100000如果週末是週六下午和週日：1000003
週時間
 week_times string

您的一周工作時間表結構。 此參數在計算一段時間內的工作時數時很有用。 使用時，此參數會覆寫week_hours參數。
開始範本
 start_template string

交替週範本的開始日期 （YYYY-MM-DD）如果您定義交替週範本排程，則必須知道範本從哪個星期日開始。
使用自訂設定
 use_custom_configuration boolean

考慮您自己的個人配置。
設定檔ID
 profile_id string

如果您在自訂設定下建立數個設定檔，則要使用的設定檔ID。 6 個字符。

傳回

名稱 路徑 類型 Description
end_date
 result.end_date string

結束日期
全部
 result.days.total string

期間內的總天數
所有星期一
 result.days.mondays string

期間內的星期一
所有星期二
 result.days.tuesdays string

期間內的星期二
所有星期三
 result.days.wednesdays string

期間內的星期三
所有星期四
 result.days.thursdays string

期間內的星期四
所有星期五
 result.days.fridays string

期間內的星期五
所有星期六
 result.days.saturdays string

期間內的星期六
所有週日
 result.days.sundays string

期間內的星期日
所有時間
 result.days.hours string

期間內的小時數
所有工作總計
 result.working_days.total string

期間內總工作天數
所有工作星期一
 result.working_days.mondays string

期間內的星期一工作
所有工作星期二
 result.working_days.tuesdays string

期間內的星期二工作
所有工作週三
 result.working_days.wednesdays string

期間內的星期三工作
所有工作週四
 result.working_days.thursdays string

期間內的星期四工作
所有工作週五
 result.working_days.fridays string

期間內的星期五工作
所有工作星期六
 result.working_days.saturdays string

期間內的週六工作
所有工作週日
 result.working_days.sundays string

期間內的週日工作
所有工作時間
 result.working_days.work_hours string

期間內工作時間
所有工資
 result.working_days.wages string

期間內工資
週末總天數
 result.weekend_days.total string

期間內的週末總天數
週一所有週末
 result.weekend_days.mondays string

期間內週一的週末
週二的所有週末
 result.weekend_days.tuesdays string

期間內週二的週末
週三所有週末
 result.weekend_days.wednesdays string

期間內週三的週末
週四的所有週末
 result.weekend_days.thursdays string

期間內週四的週末
週五的所有週末
 result.weekend_days.fridays string

期間內週五的週末
週六的所有週末
 result.weekend_days.saturdays string

期間內週六的週末
週日的所有週末
 result.weekend_days.sundays string

期間內週日的週末
公眾假期
 result.public_holidays object

公眾假期列表

新增工作天數

作業識別碼：
AddWorkingDays

在日期中新增 （或移除） 任意工作天數。

參數

名稱 機碼 必要 類型 Description
國家代碼
 country_code True string

ISO 國家代碼（2 個字母）。
開始日期
 start_date True string

開始日期（YYYY-MM-DD）
增量
 increment True string

您要新增至開始日期的工作天數 （正整數或負整數，但不是零）。
包括開始
 include_start True boolean

計數是否應該包括start_date？ 預設值為 True。
設定
 configuration string

區域預設組態的名稱。 如需詳細資訊，請參閱文件。
週末
 weekend string

你的週末結構。 週日-週一-週二-週三-週四-週五-週六。 如果您的週末是週日和週一，您可以發送：1100000如果週末是週六下午和週日：1000003
週時間
 week_times string

您的一周工作時間表結構。 此參數在計算一段時間內的工作時數時很有用。 使用時，此參數會覆寫week_hours參數。
開始範本
 start_template string

交替週範本的開始日期 （YYYY-MM-DD）如果您定義交替週範本排程，則必須知道範本從哪個星期日開始。
使用自訂設定
 use_custom_configuration boolean

考慮您自己的個人配置。
設定檔ID
 profile_id string

如果您在自訂設定下建立數個設定檔，則要使用的設定檔ID。 6 個字符。

傳回

名稱 路徑 類型 Description
end_date
 result.end_date string

結束日期
全部
 result.days.total string

期間內的總天數
所有星期一
 result.days.mondays string

期間內的星期一
所有星期二
 result.days.tuesdays string

期間內的星期二
所有星期三
 result.days.wednesdays string

期間內的星期三
所有星期四
 result.days.thursdays string

期間內的星期四
所有星期五
 result.days.fridays string

期間內的星期五
所有星期六
 result.days.saturdays string

期間內的星期六
所有週日
 result.days.sundays string

期間內的星期日
所有時間
 result.days.hours string

期間內的小時數
所有工作總計
 result.working_days.total string

期間內總工作天數
所有工作星期一
 result.working_days.mondays string

期間內的星期一工作
所有工作星期二
 result.working_days.tuesdays string

期間內的星期二工作
所有工作週三
 result.working_days.wednesdays string

期間內的星期三工作
所有工作週四
 result.working_days.thursdays string

期間內的星期四工作
所有工作週五
 result.working_days.fridays string

期間內的星期五工作
所有工作星期六
 result.working_days.saturdays string

期間內的週六工作
所有工作週日
 result.working_days.sundays string

期間內的週日工作
所有工作時間
 result.working_days.work_hours string

期間內工作時間
所有工資
 result.working_days.wages string

期間內工資
週末總天數
 result.weekend_days.total string

期間內的週末總天數
週一所有週末
 result.weekend_days.mondays string

期間內週一的週末
週二的所有週末
 result.weekend_days.tuesdays string

期間內週二的週末
週三所有週末
 result.weekend_days.wednesdays string

期間內週三的週末
週四的所有週末
 result.weekend_days.thursdays string

期間內週四的週末
週五的所有週末
 result.weekend_days.fridays string

期間內週五的週末
週六的所有週末
 result.weekend_days.saturdays string

期間內週六的週末
週日的所有週末
 result.weekend_days.sundays string

期間內週日的週末
公眾假期
 result.public_holidays object

公眾假期列表

新增工作時間

作業識別碼：
AddWorkingHours

將工作時間添加到給定的開始日期/時間。

參數

名稱 機碼 必要 類型 Description
國家代碼
 country_code True string

ISO 國家代碼（2 個字母）。
開始日期
 start_date True string

開始日期（YYYY-MM-DD）
開始時間
 start_time True string

開始時間 （HH：MM）
增量時間
 increment_time True string

要新增 （或移除） 到開始日期時間的工作時間量。 格式：H：i
設定
 configuration string

區域預設組態的名稱。 如需詳細資訊，請參閱文件。
週末
 weekend string

你的週末結構。 週日-週一-週二-週三-週四-週五-週六。 如果您的週末是週日和週一，您可以發送：1100000如果週末是週六下午和週日：1000003
週時間
 week_times string

您的一周工作時間表結構。 此參數在計算一段時間內的工作時數時很有用。 使用時，此參數會覆寫week_hours參數。
開始範本
 start_template string

交替週範本的開始日期 （YYYY-MM-DD）如果您定義交替週範本排程，則必須知道範本從哪個星期日開始。
使用自訂設定
 use_custom_configuration boolean

考慮您自己的個人配置。
設定檔ID
 profile_id string

如果您在自訂設定下建立數個設定檔，則要使用的設定檔ID。 6 個字符。

傳回

名稱 路徑 類型 Description
結束日期
 result.end_date string

計算的結束日期。
結束時間
 result.end_time string

計算的結束時間。

新增週末

作業識別碼：
AddWeekendDays

將週末天數新增至指定日期。

參數

名稱 機碼 必要 類型 Description
國家代碼
 country_code True string

ISO 國家代碼（2 個字母）。
開始日期
 start_date True string

開始日期（YYYY-MM-DD）
增量
 increment True string

您要新增至開始日期的週末天數 （正或負整數，但不是零）。
包括開始
 include_start True boolean

計數是否應該包括start_date？ 預設值為 True。
設定
 configuration string

區域預設組態的名稱。 如需詳細資訊，請參閱文件。
週末
 weekend string

你的週末結構。 週日-週一-週二-週三-週四-週五-週六。 如果您的週末是週日和週一，您可以發送：1100000如果週末是週六下午和週日：1000003
週時間
 week_times string

您的一周工作時間表結構。 此參數在計算一段時間內的工作時數時很有用。 使用時，此參數會覆寫week_hours參數。
開始範本
 start_template string

交替週範本的開始日期 （YYYY-MM-DD）如果您定義交替週範本排程，則必須知道範本從哪個星期日開始。
使用自訂設定
 use_custom_configuration boolean

考慮您自己的個人配置。
設定檔ID
 profile_id string

如果您在自訂設定下建立數個設定檔，則要使用的設定檔ID。 6 個字符。

傳回

名稱 路徑 類型 Description
end_date
 result.end_date string

結束日期
全部
 result.days.total string

期間內的總天數
所有星期一
 result.days.mondays string

期間內的星期一
所有星期二
 result.days.tuesdays string

期間內的星期二
所有星期三
 result.days.wednesdays string

期間內的星期三
所有星期四
 result.days.thursdays string

期間內的星期四
所有星期五
 result.days.fridays string

期間內的星期五
所有星期六
 result.days.saturdays string

期間內的星期六
所有週日
 result.days.sundays string

期間內的星期日
所有時間
 result.days.hours string

期間內的小時數
所有工作總計
 result.working_days.total string

期間內總工作天數
所有工作星期一
 result.working_days.mondays string

期間內的星期一工作
所有工作星期二
 result.working_days.tuesdays string

期間內的星期二工作
所有工作週三
 result.working_days.wednesdays string

期間內的星期三工作
所有工作週四
 result.working_days.thursdays string

期間內的星期四工作
所有工作週五
 result.working_days.fridays string

期間內的星期五工作
所有工作星期六
 result.working_days.saturdays string

期間內的週六工作
所有工作週日
 result.working_days.sundays string

期間內的週日工作
所有工作時間
 result.working_days.work_hours string

期間內工作時間
所有工資
 result.working_days.wages string

期間內工資
週末總天數
 result.weekend_days.total string

期間內的週末總天數
週一所有週末
 result.weekend_days.mondays string

期間內週一的週末
週二的所有週末
 result.weekend_days.tuesdays string

期間內週二的週末
週三所有週末
 result.weekend_days.wednesdays string

期間內週三的週末
週四的所有週末
 result.weekend_days.thursdays string

期間內週四的週末
週五的所有週末
 result.weekend_days.fridays string

期間內週五的週末
週六的所有週末
 result.weekend_days.saturdays string

期間內週六的週末
週日的所有週末
 result.weekend_days.sundays string

期間內週日的週末
公眾假期
 result.public_holidays object

公眾假期列表

檢查配額

作業識別碼：
Quota

檢查當月內使用和下個月可用的剩餘天數配額。

傳回

名稱 路徑 類型 Description
State
 result.state string

您的計劃狀態 （1：作用中、2：已取消、-1：錯誤）。
Current
 result.current string

目前配額（本月內剩餘天數）。
Next
 result.next string

下個月的名額可用。

獲取日期資訊

作業識別碼：
GetInfoDay

取得特定日期的詳細資訊。

參數

名稱 機碼 必要 類型 Description
國家代碼
 country_code True string

ISO 國家代碼（2 個字母）。
Date
 date True string

要分析的日期 （YYYY-MM-DD）
設定
 configuration string

區域預設組態的名稱。 如需詳細資訊，請參閱文件。
週末
 weekend string

你的週末結構。 週日-週一-週二-週三-週四-週五-週六。 如果您的週末是週日和週一，您可以發送：1100000如果週末是週六下午和週日：1000003
使用自訂設定
 use_custom_configuration boolean

考慮您自己的個人配置。
設定檔ID
 profile_id string

如果您在自訂設定下建立數個設定檔，則要使用的設定檔ID。 6 個字符。

傳回

名稱 路徑 類型 Description
工作日
 result.working_day string

這是工作日嗎（0 表示沒有）。
上班時間
 result.work_hours string

當天的工作時數。
俸
 result.wages string

俸
早上開始
 result.morning_start string

早晨開始的時間
上午結束
 result.morning_end string

早晨結束的時間
下午開始
 result.afternoon_start string

下午開始的時間
下午結束
 result.afternoon_end string

下午結束的時間
公眾假期
 result.public_holiday string

這是公共假期嗎（0 表示沒有）。
公眾假期說明
 result.public_holiday_description string

此公共假期的說明
週末
 result.weekend_day string

這是週末嗎（0 表示不是）。
自訂日期
 result.custom_date string

這是自定義日期嗎（0 表示否）。
自訂日期說明
 result.custom_date_description string

此自訂日期的說明。
自訂日期顏色
 result.custom_date_color string

為此自訂日期定義的顏色。