共用方式為


持續時間計算器 (獨立發行者) (預覽)

全面的持續時間和時間計算連接器,支援企業應用程式的工作日、時區、薪資週期、專案時間表和進階 DST 計算。

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

服務 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://www.troystaylor.com
Email troy@troystaylor.com
連接器中繼資料
Publisher 特洛伊·泰勒
網站 https://www.troystaylor.com
隱私策略 https://www.troystaylor.com
類別 生產力

節流限制

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

動作

取得 DST 歷史記錄

擷取歷史夏令時轉換資料,以進行分析和合規性報告。

取得時區資訊

檢索全面的時區信息,包括 DST 規則、當前偏移量和區域詳細信息。

計算 DST 轉換

計算特定的夏令時過渡日期並分析其對持續時間的影響。

計算全球工作時間

透過區域假日支援和自訂時間表計算多個時區的工作時間。

計算專案工期

透過里程碑追蹤、關鍵路徑分析和專案狀態計算來分析專案時間表。

計算工作天數

計算兩個日期之間的工作天數,不包括週末和可選假日。

計算工作時間

追蹤和計算工作時間,支援自訂時間表、加班規則和休息時間計算。

計算年齡

使用多種輸出格式(包括年、月、日和總時間單位)計算日期之間的精確年齡和持續時間。

計算截止日期

計算到截止日期的剩餘時間,並提供詳細的細分和里程碑跟踪。

計算最佳會議時間

找到跨多個時區的最佳會議時間,並具有可用性限制和工作時間。

計算薪資期間

使用工作日計算生成每週、每兩週、半月或每月時間表的工資週期。

計算跨時區持續時間

計算不同時區兩個日期時間之間的持續時間,並考慮 DST 變更。

轉換時區

通過自動 DST 檢測和調整在 25+ 支持的時區之間轉換日期時間。

驗證 DST 計算

驗證和分析夏令時計算的準確性和合規性。

取得 DST 歷史記錄

擷取歷史夏令時轉換資料,以進行分析和合規性報告。

參數

名稱 機碼 必要 類型 Description
時區
Time Zones string

IANA 時區識別碼。

開始年份
startYear integer

歷程記錄的開始年份 (預設值:2000)。

結束年份
endYear integer

歷程記錄的結束年份 (預設值:目前年份)。

包括政治變革
includePoliticalChanges boolean

是否包括政治/立法變革。

傳回

取得時區資訊

檢索全面的時區信息,包括 DST 規則、當前偏移量和區域詳細信息。

參數

名稱 機碼 必要 類型 Description
時區
Time Zones string

IANA 時區識別碼。

參考日期
referenceDate string

時區資訊的參考日期。

包括歷史記錄
includeHistory boolean

是否要包含歷程 DST 資訊。

傳回

計算 DST 轉換

計算特定的夏令時過渡日期並分析其對持續時間的影響。

參數

名稱 機碼 必要 類型 Description
時區
timeZone True string

要分析 DST 轉換的時區 (IANA 時區)。

year True integer

分析年份。

包含規則
includeRules boolean

是否包含轉換規則。

包括影響
includeImpact boolean

是否包含影響分析。

傳回

計算全球工作時間

透過區域假日支援和自訂時間表計算多個時區的工作時間。

參數

名稱 機碼 必要 類型 Description
開始日期時間
startDateTime True date-time

計算的開始日期和時間。

結束日期時間
endDateTime True date-time

計算的結束日期和時間。

時區
Time Zones string

IANA 時區識別碼。

開始時間
startTime time

每日開始時間(HH:mm 格式)。

結束時間
endTime time

每日結束時間 (HH:mm 格式)。

工作天
workingDays array of string

一週的工作日。

包括假期
includeHolidays boolean

是否考慮地區假日。

傳回

計算專案工期

透過里程碑追蹤、關鍵路徑分析和專案狀態計算來分析專案時間表。

參數

名稱 機碼 必要 類型 Description
開始日期
startDate True string

專案開始日期。

結束日期
endDate True string

專案結束日期。

項目狀態
projectStatus string

工期計算的目前專案狀態。

里程碑名稱
name True string

里程碑名稱或標題。

里程碑日期
date True string

里程碑目標日期。

假期日期
date True string

假期的日期。

節日名稱
name string

節日名稱。

假日類型
type string

用於分類的假期類別。

節日紀念
observance string

如何慶祝節日。

包括週末
includeWeekends boolean

是否將週末納入專案持續時間。

輸出格式
outputFormat string

持續時間計算的首選輸出格式。

工作時間期間
workingHoursPeriod string

用於計算的工作時間期間類型。

傳回

計算工作天數

計算兩個日期之間的工作天數,不包括週末和可選假日。

參數

名稱 機碼 必要 類型 Description
開始日期
startDate True string

工作日計算的開始日期。

結束日期
endDate True string

工作日計算的結束日期。

假期日期
holidays array of string

要從工作日計算中排除的假日日期的可選清單。

包括開始日期
includeStartDate boolean

是否要在計算中包括開始日期。

傳回

計算工作時間

追蹤和計算工作時間,支援自訂時間表、加班規則和休息時間計算。

參數

名稱 機碼 必要 類型 Description
開始日期時間
startDateTime True date-time

工作時數計算的開始日期和時間。

結束日期時間
endDateTime True date-time

工作時數計算的結束日期和時間。

工作開始時間
start string

工作日開始時間(例如,“09:00”)。

工作結束時間
end string

工作日結束時間(例如,“17:00”)。

加班費
overtimeRate number

加班乘數(例如,1.5 表示半小時)。

休息時間
breakHours number

從工作時間中減去的每日休息時間(以小時為單位)。

傳回

計算年齡

使用多種輸出格式(包括年、月、日和總時間單位)計算日期之間的精確年齡和持續時間。

參數

名稱 機碼 必要 類型 Description
出生日期
birthDate True date-time

用於計算年齡的出生日期和時間。

截至日期
asOfDate date-time

計算截至此日期的年齡。 如果未提供,則預設為目前日期。

包括時間
includeTime boolean

是否在年齡計算中包含時間精確度。

傳回

計算截止日期

計算到截止日期的剩餘時間,並提供詳細的細分和里程碑跟踪。

參數

名稱 機碼 必要 類型 Description
截止日期
deadlineDate True date-time

目標截止日期日期和時間。

目前日期
currentDate date-time

當前計算日期。 如果未提供,則預設為現在。

包括週末
includeWeekends boolean

是否將週末納入計算。

假期
holidays array of string

要從計算中排除的假日日期清單。

傳回

計算最佳會議時間

找到跨多個時區的最佳會議時間,並具有可用性限制和工作時間。

參數

名稱 機碼 必要 類型 Description
參與者姓名
participantName string

參與者名稱。

當地日期時間
localDateTime date-time

參加者當地時區的會議時間。

timeZone
timeZone string

IANA 時區識別碼。

在工作時間內
isWithinWorkingHours boolean

時間是否在工作時間內。

衝突等級
conflictLevel string

排程衝突的層級。

持續時間分鐘
durationMinutes True integer

會議持續時間(以分鐘為單位)。

會議類型
meetingType string

會議類型,以實現最佳排程。

會議優先順序
priority string

會議排程的優先級。

開始日期
startDate True string

範圍的開始日期。

結束日期
endDate True string

範圍的結束日期。

開始時間
startTime time

每日開始時間(HH:mm 格式)。

結束時間
endTime time

每日結束時間 (HH:mm 格式)。

工作天
workingDays array of string

一週的工作日。

開始時間
startTime True date-time

時段的開始時間。

結束時間
endTime True date-time

時段的結束時間。

Description
description string

時段說明。

傳回

計算薪資期間

使用工作日計算生成每週、每兩週、半月或每月時間表的工資週期。

參數

名稱 機碼 必要 類型 Description
開始日期
startDate True string

薪資期間計算的開始日期。

結束日期
endDate string

薪資期間計算的結束日期。 如果未提供,則從開始日期開始計算一個期間。

期間類型
periodType True string

要計算的薪資週期類型。

包括部分句點
includePartialPeriods boolean

是否要在開頭或結尾包含部分句點。

傳回

計算跨時區持續時間

計算不同時區兩個日期時間之間的持續時間,並考慮 DST 變更。

參數

名稱 機碼 必要 類型 Description
開始日期時間
startDateTime True date-time

開始時區的開始日期和時間。

startTimeZone
startTimeZone True string

IANA 時區識別碼。

結束日期時間
endDateTime True date-time

結束時區的結束日期和時間。

endTimeZone
endTimeZone True string

IANA 時區識別碼。

DST 帳戶
accountForDst boolean

是否考慮夏令時轉換。

傳回

轉換時區

通過自動 DST 檢測和調整在 25+ 支持的時區之間轉換日期時間。

參數

名稱 機碼 必要 類型 Description
日期時間
dateTime True date-time

要轉換的日期和時間。

from時區
fromTimeZone True string

IANA 時區識別碼。

到時區
toTimeZone True string

IANA 時區識別碼。

傳回

驗證 DST 計算

驗證和分析夏令時計算的準確性和合規性。

參數

名稱 機碼 必要 類型 Description
計算 ID
calculationId True string

計算的唯一識別碼。

時區
timeZone True string

計算的時區(IANA 時區)。

開始日期時間
startDateTime True date-time

開始日期與時間。

結束日期時間
endDateTime True date-time

結束日期和時間。

總天數
totalDays integer

總天數。

總時數
totalHours integer

總小時數。

總分鐘數
totalMinutes integer

總分鐘數。

總秒數
totalSeconds integer

總秒數。

Years
years integer

完整年數。

月份
months integer

完成年後的額外幾個月。

days integer

完整幾個月後的額外天數。

小時
hours integer

完整幾天後額外數小時。

會議記錄
minutes integer

完整小時後額外幾分鐘。

seconds integer

完整分鐘後的額外秒數。

驗證規則
validationRules array of string

要套用的驗證規則。

合規標準
complianceStandard string

要驗證的合規性標準。

傳回

定義

TimeZoneEnum

IANA 時區識別碼。

IANA 時區識別碼。

營業日回應

名稱 路徑 類型 Description
開始日期
startDate string

計算中使用的開始日期。

結束日期
endDate string

計算中使用的結束日期。

營業日
businessDays integer

日期之間的工作天總數。

總天數
totalDays integer

日期之間的總日曆天數。

週末
weekendDays integer

不包括週末天數。

假日
holidayDays integer

不包括假期天數。

Range 內的假期
holidaysInRange array of string

屬於日期範圍內的假日清單。

AgeCalculationResponse

名稱 路徑 類型 Description
出生日期
birthDate date-time

計算中使用的出生日期。

計算日期
calculationDate date-time

日期年齡計算為。

年齡(以歲為單位)
ageYears integer

以完整年齡計。

額外月份
ageMonths integer

完整年份之外的額外月份。

額外天數
ageDays integer

超過完整年和月的額外天數。

總天數
totalDays integer

總年齡(以天為單位)。

總時數
totalHours integer

總年齡(以小時為單位)。

總分鐘數
totalMinutes integer

總年齡(以分鐘為單位)。

格式化年齡
formattedAge string

人類可讀的格式化年齡字串。

WorkingHoursResponse

名稱 路徑 類型 Description
開始日期時間
startDateTime date-time

計算中使用的開始日期和時間。

結束日期時間
endDateTime date-time

計算中使用的結束日期和時間。

總時數
totalHours number

計算的總工作時間。

正常營業時間
regularHours number

正常工作時間(非加班)。

加班時間
overtimeHours number

計算加班時間。

總天數
totalDays integer

期間內的總日曆天數。

工作天
workingDays integer

總工作天數(不包括週末)。

TimeZoneConversion回應

名稱 路徑 類型 Description
原始日期時間
originalDateTime date-time

提供的原始日期和時間。

轉換的日期時間
convertedDateTime date-time

目標時區的轉換日期和時間。

從時區出發
fromTimeZone string

使用的來源時區。

前往時區
toTimeZone string

使用的目標時區。

偏移差異
offsetDifference string

區域之間的時差。

DST 活動
isDstActive boolean

夏令時是否有效。

ProjectDuration回應

名稱 路徑 類型 Description
開始日期
startDate string

專案開始日期。

結束日期
endDate string

專案結束日期。

總日曆天數
totalCalendarDays integer

專案中的行事曆天數總計。

總營業天數
totalBusinessDays integer

專案中的總工作天數。

項目狀態
projectStatus string

當前項目狀態評估。

里程碑分析
milestones array of MilestoneAnalysis

分析里程碑資訊。

關鍵路徑
criticalPath CriticalPath

里程碑分析

名稱 路徑 類型 Description
里程碑名稱
name string

里程碑名稱。

里程碑日期
date string

里程碑日期。

從開始開始的天數
daysFromStart integer

從專案開始到里程碑的天數。

結束天數
daysToEnd integer

從里程碑到專案結束的天數。

完成百分比
percentComplete number

在里程碑完成的專案時間表百分比。

逾期
isOverdue boolean

里程碑是否逾期。

關鍵路徑

名稱 路徑 類型 Description
有關鍵路徑
hasCriticalPath boolean

是否確定了關鍵里程碑。

關鍵里程碑
criticalMilestones array of string

重要里程碑的名稱。

推薦焦點
recommendedFocus string

專案成功的建議重點領域。

Dst驗證回應

名稱 路徑 類型 Description
驗證結果
validationResults array of DstValidationResult

每個計算的驗證結果。

整體合規性
overallCompliance boolean

所有計算是否都通過驗證。

合規分數
complianceScore number

整體合規分數 (0-100)。

Recommendations
recommendations array of string

修正驗證問題的建議。

Dst驗證結果

名稱 路徑 類型 Description
計算 ID
calculationId string

計算識別碼。

有效
isValid boolean

計算是否有效。

實際結果
actualResult DurationBreakdown
偏差
deviations array of ValidationDeviation

與預期結果的偏差。

合規問題
complianceIssues array of string

發現合規性問題。

驗證偏差

名稱 路徑 類型 Description
領域
field string

有偏差的欄位。

預期
expected string

預期值。

實際
actual string

實際值。

Severity
severity string

偏差的嚴重程度。

TimeZoneInfo回應

名稱 路徑 類型 Description
時區詳細資料
timeZoneDetails array of TimeZoneDetail

每個時區的詳細信息。

Comparisons
comparisons array of TimeZoneComparison

時區之間的比較。

時區詳細資料

名稱 路徑 類型 Description
時區 ID
timeZoneId string

時區識別碼。

顯示名稱
displayName string

人類可讀的時區名稱。

電流偏移
currentOffset string

目前的 UTC 偏移量。

標準偏移
standardOffset string

標準時間 UTC 偏移。

夏令時嗎
isDaylightSaving boolean

目前是否處於夏令時。

dst規則
dstRules DstRules
地區資訊
regionalInfo RegionalInfo

Dst規則

名稱 路徑 類型 Description
使用夏令時
usesDst boolean

時區是否使用 DST。

彈簧前向規則
springForwardRule string

彈簧向前過渡的規則。

後援規則
fallBackRule string

後援轉換的規則。

下一個轉變
nextTransition date-time

下一個 DST 過渡日期。

區域資訊

名稱 路徑 類型 Description
國家
countries array of string

使用此時區的國家/地區。

主要城市
majorCities array of string

這個時區的主要城市。

政治地位
politicalStatus string

夏令時採用的政治地位。

時區比較

名稱 路徑 類型 Description
時區 1
timeZone1 string

第一個時區。

時區 2
timeZone2 string

第二時區。

偏移差異
offsetDifference string

區域之間的時差。

相同的季節性模式
sameSeasonalPattern boolean

區域是否遵循相同的 DST 模式。

DstTransition回應

名稱 路徑 類型 Description
時區
timeZone string

分析的時區(IANA 時區)。

year integer

年份分析。

轉換
transitions array of DstTransition

今年的夏令時過渡。

總轉換
totalTransitions integer

轉換總數。

影響分析
impactAnalysis DstImpactAnalysis

Dst影響分析

名稱 路徑 類型 Description
受影響時間
affectedHours integer

受轉換影響的總時數。

業務影響
businessImpact string

評估的業務影響等級。

Recommendations
recommendations array of string

處理轉換的建議。

關鍵時期
criticalPeriods array of CriticalPeriod

需要注意的關鍵時期。

CriticalPeriod

名稱 路徑 類型 Description
開始日期時間
startDateTime date-time

關鍵期的開始。

結束日期時間
endDateTime date-time

關鍵期結束。

Description
description string

關鍵時期的描述。

Severity
severity string

嚴重性層級。

DstHistory回應

名稱 路徑 類型 Description
時區歷史記錄
timeZoneHistories array of TimeZoneHistory

每個時區的 DST 歷史記錄。

摘要
summary DstHistorySummary

時區歷史

名稱 路徑 類型 Description
時區
timeZone string

時區識別碼。

歷史轉變
historicalTransitions array of HistoricalDstTransition

歷史 DST 轉換。

總轉換
totalTransitions integer

記錄的 DST 轉換總數。

政策變更
policyChanges array of DstPolicyChange

DST 原則會隨著時間而變更。

歷史Dst轉換

名稱 路徑 類型 Description
year integer

過渡之年。

轉換類型
transitionType string

DST 轉換的類型。

過渡日期
transitionDate date-time

轉換的日期和時間。

偏移變更
offsetChange string

UTC 偏移量變更。

套用的規則
ruleApplied string

DST 規則。

DstPolicy變更

名稱 路徑 類型 Description
生效日期
effectiveDate string

政策變更生效的日期。

變更說明
changeDescription string

政策變更的描述。

原因
reason string

政策變更的原因。

Impact
impact string

變更的影響層級。

Dst歷史摘要

名稱 路徑 類型 Description
時區總數
totalTimeZones integer

分析的時區總數。

總轉換
totalTransitions integer

所有時區的轉換總數。

最活躍時區
mostActiveTimeZone string

DST 變更最多的時區。

趨勢
trends array of string

觀察到的 DST 趨勢。

全域模式
globalPatterns array of string

全球 DST 採用模式。

參與者當地時間

名稱 路徑 類型 Description
參與者姓名
participantName string

參與者名稱。

當地日期時間
localDateTime date-time

參加者當地時區的會議時間。

timeZone
timeZone TimeZoneEnum

IANA 時區識別碼。

在工作時間內
isWithinWorkingHours boolean

時間是否在工作時間內。

衝突等級
conflictLevel string

排程衝突的層級。

PayrollPeriods回應

名稱 路徑 類型 Description
期間類型
periodType string

計算的薪資週期類型。

總期間
totalPeriods integer

薪資週期總數。

完整時期
completePeriods integer

完整薪資週期數。

部分經期
partialPeriods integer

部分薪資週期數。

期間
periods array of PayrollPeriod

所有工資單期間的列表以及詳細信息。

薪資期間

名稱 路徑 類型 Description
期間編號
periodNumber integer

薪資期間的序號。

開始日期
startDate string

薪資期間的開始日期。

結束日期
endDate string

薪資期間的結束日期。

工作天
workingDays integer

期間內的工作天數。

是部分的
isPartial boolean

這是否是部分時期。

DeadlineCalculation回應

名稱 路徑 類型 Description
截止日期
deadlineDate date-time

目標截止日期日期和時間。

目前日期
currentDate date-time

用於計算的當前日期。

剩餘時間
timeRemaining DurationBreakdown
剩餘工作天數
businessDaysRemaining integer

剩餘工作天數。

逾期
isPastDue boolean

是否已過期限。

嚴重狀態
criticalStatus string

截止日期時間表的狀態。

CrossTzDuration回應

名稱 路徑 類型 Description
開始日期時間 UTC
startDateTimeUtc date-time

開始日期和時間轉換為 UTC。

結束日期時間 UTC
endDateTimeUtc date-time

結束日期和時間轉換為 UTC。

duration
duration DurationBreakdown
DST 轉換
dstTransitions array of DstTransition

期間發生的 DST 轉換清單。

起始偏移
timeZoneOffset.startOffset string

開始時間的 UTC 偏移。

端點偏移
timeZoneOffset.endOffset string

結束時間的 UTC 偏移。

GlobalWorkingHours回應

名稱 路徑 類型 Description
總工作時間
totalWorkingHours double

所有時區的總工作時間。

時區結果
timeZoneResults array of object

按時區劃分的工作時間細分。

時區
timeZoneResults.timeZone string

時區識別碼。

工作時間
timeZoneResults.workingHours double

此時區的工作時間。

營業日
timeZoneResults.businessDays integer

工作天數。

重疊時間
overlapHours double

所有時區都有重疊工作時間的時間。

會議時間回應

名稱 路徑 類型 Description
最佳時間
optimalTimes array of object

按適用性排序的最佳會議時間列表。

開始時間
optimalTimes.startTime date-time

會議開始時間(UTC)。

結束時間
optimalTimes.endTime date-time

會議結束時間(UTC)。

適用性分數
optimalTimes.suitabilityScore double

表示這次的合適程度的分數(0-100)。

參加時間
optimalTimes.participantTimes array of ParticipantLocalTime

每位參與者的當地時間。

Conflicts
optimalTimes.conflicts array of object

排程衝突清單。

參與者 ID
optimalTimes.conflicts.participantId string

有衝突的參與者的 ID。

衝突類型
optimalTimes.conflicts.conflictType string

排程衝突的類型。

衝突等級
optimalTimes.conflicts.severity string

排程衝突的層級。

獨特的時區
timeZoneAnalysis.uniqueTimeZones integer

唯一時區的數目。

最大時間偏移
timeZoneAnalysis.maxTimeOffset double

參與者之間的最大時差(以小時為單位)。

持續時間細分

名稱 路徑 類型 Description
總天數
totalDays integer

總天數。

總時數
totalHours integer

總小時數。

總分鐘數
totalMinutes integer

總分鐘數。

總秒數
totalSeconds integer

總秒數。

Years
years integer

完整年數。

月份
months integer

完成年後的額外幾個月。

days integer

完整幾個月後的額外天數。

小時
hours integer

完整幾天後額外數小時。

會議記錄
minutes integer

完整小時後額外幾分鐘。

seconds integer

完整分鐘後的額外秒數。

Dst轉換

名稱 路徑 類型 Description
過渡日期
transitionDate date-time

DST 轉換發生的日期和時間。

時區
timeZone string

發生轉換的時區。

轉換類型
transitionType string

DST 轉換的類型。

偏移前
offsetBefore string

轉換前的 UTC 偏移量(例如,'-05:00')。

偏移之後
offsetAfter string

轉換後的 UTC 偏移量(例如,'-04:00')。

時間調整
timeAdjustment integer

時間調整(以分鐘為單位)(彈簧向前+60 -60,後退+60)。