持续时间计算器（独立发布者）（预览版）

一个全面的持续时间和时间计算连接器，支持企业应用程序的工作日、时区、工资周期、项目日程表和高级 DST 计算。

此连接器在以下产品和区域中可用：

服务	Class	区域
Copilot Studio	高级	除以下各项外的所有 Power Automate 区域： - 美国政府（GCC） - 美国政府（GCC High） - 由世纪互联运营的中国云 - 美国国防部（DoD）
逻辑应用程序	标准	除以下各项外的所有逻辑应用区域： - Azure 政府区域 - Azure 中国区域 - 美国国防部（DoD）
Power Apps	高级	除以下各项外的所有 Power Apps 区域： - 美国政府（GCC） - 美国政府（GCC High） - 由世纪互联运营的中国云 - 美国国防部（DoD）
Power Automate	高级	除以下各项外的所有 Power Automate 区域： - 美国政府（GCC） - 美国政府（GCC High） - 由世纪互联运营的中国云 - 美国国防部（DoD）

联系人
Name	特洛伊·泰勒
URL	https://www.troystaylor.com
Email	troy@troystaylor.com

连接器元数据
发布者	特洛伊·泰勒
Website	https://www.troystaylor.com
隐私策略	https://www.troystaylor.com
类别	生产力

限制

名称	调用	续订期
每个连接的 API 调用数	100	60 秒

操作

获取 DST 历史记录	检索历史夏令时转换数据以进行分析和符合性报告。
获取时区信息	检索全面的时区信息，包括 DST 规则、当前偏移量和区域详细信息。
计算 DST 转换	计算特定的夏令时转换日期，并分析它们对工期的影响。
计算全局工作时间	使用区域假日支持和自定义计划计算多个时区的工作时间。
计算工作日	计算两个日期之间的工作日数，不包括周末和可选假日。
计算工作时间	跟踪和计算工作时间，并支持自定义计划、加班规则和中断时间计算。
计算工资周期	使用工作日计算为每周、双周、半月或每月计划生成工资周期。
计算年龄	计算具有多种输出格式的日期之间的精确年龄和持续时间，包括年、月、天和总时间单位。
计算截止时间	计算剩余时间，直到最后期限，详细细分和里程碑跟踪。
计算最佳会议时间	在具有可用性约束和工作时间的多个时区中查找最佳会议时间。
计算跨时区持续时间	计算不同时区的两个日期时间之间的持续时间，这考虑了 DST 更改。
计算项目工期	使用里程碑跟踪、关键路径分析和项目状态计算分析项目日程表。
转换时区	使用自动 DST 检测和调整在 25 个以上的受支持时区之间转换日期时间。
验证 DST 计算	验证和分析夏令时计算的准确性和符合性。

获取 DST 历史记录

操作 ID:: GetDstHistory

检索历史夏令时转换数据以进行分析和符合性报告。

参数

名称	密钥	类型	说明
时区	Time Zones	string	IANA 时区标识符。
开始年份	startYear	integer	历史记录的开始日期（默认值：2000）。
年底	endYear	integer	历史记录的结束年（默认值：当前年份）。
包括政治变化	includePoliticalChanges	boolean	是否包括政治/立法改革。

Body: DstHistoryResponse

获取时区信息

操作 ID:: GetTimeZoneInfo

检索全面的时区信息，包括 DST 规则、当前偏移量和区域详细信息。

参数

名称	密钥	类型	说明
时区	Time Zones	string	IANA 时区标识符。
参考日期	referenceDate	string	时区信息的参考日期。
包括历史记录	includeHistory	boolean	是否包括历史 DST 信息。

Body: TimeZoneInfoResponse

计算 DST 转换

操作 ID:: CalculateDstTransition

计算特定的夏令时转换日期，并分析它们对工期的影响。

参数

名称	密钥	必需	类型	说明
时区	timeZone	True	string	要分析 DST 转换的时区（IANA 时区）。
年份	year	True	integer	要分析的年份。
包括规则	includeRules		boolean	是否包含转换规则。
包括影响	includeImpact		boolean	是否包括影响分析。

Body: DstTransitionResponse

计算全局工作时间

操作 ID:: CalculateGlobalWorkingHours

使用区域假日支持和自定义计划计算多个时区的工作时间。

参数

名称	密钥	必需	类型	说明
开始日期时间	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	是否考虑区域假日。

Body: GlobalWorkingHoursResponse

计算工作日

操作 ID:: CalculateBusinessDays

计算两个日期之间的工作日数，不包括周末和可选假日。

参数

名称	密钥	必需	类型	说明
开始日期	startDate	True	string	工作日计算的开始日期。
结束日期	endDate	True	string	工作日计算的结束日期。
假日日期	holidays		array of string	要从工作日计算中排除的假日日期的可选列表。
包括开始日期	includeStartDate		boolean	是否在计算中包含开始日期。

Body: BusinessDaysResponse

计算工作时间

操作 ID:: CalculateWorkingHours

跟踪和计算工作时间，并支持自定义计划、加班规则和中断时间计算。

参数

名称	密钥	必需	类型	说明
开始日期时间	startDateTime	True	date-time	工作时间计算的开始日期和时间。
结束日期时间	endDateTime	True	date-time	工作时间计算的结束日期和时间。
工作开始时间	start		string	工作日开始时间（例如“09：00”）。
工时结束时间	end		string	工作日结束时间（例如“17：00”）。
加班费率	overtimeRate		number	加班乘数率（例如，1.5 用于时间半）。
中断小时数	breakHours		number	每日休息时间（以小时为单位）减去工作时间。

Body: WorkingHoursResponse

计算工资周期

操作 ID:: CalculatePayrollPeriods

使用工作日计算为每周、双周、半月或每月计划生成工资周期。

参数

名称	密钥	必需	类型	说明
开始日期	startDate	True	string	工资周期计算的开始日期。
结束日期	endDate		string	工资周期计算的结束日期。如果未提供，则从开始日期计算一个周期。
句点类型	periodType	True	string	要计算的工资周期的类型。
包括部分时间段	includePartialPeriods		boolean	是否在开头或结尾包含部分句点。

Body: PayrollPeriodsResponse

计算年龄

操作 ID:: CalculateAge

计算具有多种输出格式的日期之间的精确年龄和持续时间，包括年、月、天和总时间单位。

参数

名称	密钥	必需	类型	说明
出生日期	birthDate	True	date-time	年龄计算的出生日期和时间。
截至日期	asOfDate		date-time	计算此日期的年龄。如果未提供，则默认为当前日期。
包括时间	includeTime		boolean	是否在年龄计算中包含时间精度。

Body: AgeCalculationResponse

计算截止时间

操作 ID:: DeadlineCalculation

计算剩余时间，直到最后期限，详细细分和里程碑跟踪。

参数

名称	密钥	必需	类型	说明
截止时间日期	deadlineDate	True	date-time	目标截止时间日期和时间。
当前日期	currentDate		date-time	计算的当前日期。如果未提供，则默认为现在。
包括周末	includeWeekends		boolean	是否在计算中包含周末。
假期	holidays		array of string	要从计算中排除的假日日期列表。

Body: DeadlineCalculationResponse

计算最佳会议时间

操作 ID:: CalculateMeetingTimes

在具有可用性约束和工作时间的多个时区中查找最佳会议时间。

参数

名称	密钥	必需	类型	说明
参与者名称	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	时间段的说明。

Body: MeetingTimesResponse

计算跨时区持续时间

操作 ID:: CrossTzDuration

计算不同时区的两个日期时间之间的持续时间，这考虑了 DST 更改。

参数

名称	密钥	必需	类型	说明
开始日期时间	startDateTime	True	date-time	开始时区中的开始日期和时间。
startTimeZone	startTimeZone	True	string	IANA 时区标识符。
结束日期时间	endDateTime	True	date-time	结束时区中的日期和时间。
endTimeZone	endTimeZone	True	string	IANA 时区标识符。
DST 帐户	accountForDst		boolean	是否考虑夏令时转换。

Body: CrossTzDurationResponse

计算项目工期

操作 ID:: CalculateProjectDuration

使用里程碑跟踪、关键路径分析和项目状态计算分析项目日程表。

参数

名称	密钥	必需	类型	说明
开始日期	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	计算的工作时间类型。

Body: ProjectDurationResponse

转换时区

操作 ID:: ConvertTimeZones

使用自动 DST 检测和调整在 25 个以上的受支持时区之间转换日期时间。

参数

名称	密钥	必需	类型	说明
日期时间	dateTime	True	date-time	要转换的日期和时间。
fromTimeZone	fromTimeZone	True	string	IANA 时区标识符。
toTimeZone	toTimeZone	True	string	IANA 时区标识符。

Body: TimeZoneConversionResponse

验证 DST 计算

操作 ID:: ValidateDstCalculations

验证和分析夏令时计算的准确性和符合性。

参数

名称	密钥	必需	类型	说明
计算 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		integer	完整年数。
月数	months		integer	完成几年后再过几个月。
天数	days		integer	完成几个月后再过几天。
小时	hours		integer	完成几天后再多小时。
分钟	minutes		integer	完成数小时后再加几分钟。
秒	seconds		integer	完成几分钟后再几秒钟。
验证规则	validationRules		array of string	要应用的验证规则。
符合性标准	complianceStandard		string	要验证的符合性标准。

Body: DstValidationResponse

定义

TimeZoneEnum

IANA 时区标识符。

: string

BusinessDaysResponse

名称	路径	类型	说明
开始日期	startDate	string	计算中使用的开始日期。
结束日期	endDate	string	计算中使用的结束日期。
工作日	businessDays	integer	日期之间的工作日总数。
总天数	totalDays	integer	日期之间的日历天数总数。
周末日期	weekendDays	integer	排除的周末天数。
假日日期	holidayDays	integer	排除的假日天数。
Range 中的假日	holidaysInRange	array of string	日期范围内的假日列表。

AgeCalculationResponse

名称	路径	类型	说明
出生日期	birthDate	date-time	计算中使用的出生日期。
计算日期	calculationDate	date-time	计算日期期限。
年龄（年）	ageYears	integer	完整年份的年龄。
其他月份	ageMonths	integer	超过整个年份的更多月。
其他天数	ageDays	integer	超过完整年和月的其他天数。
总天数	totalDays	integer	总年龄（以天为单位）。
总小时数	totalHours	integer	总年龄（以小时为单位）。
总分钟数	totalMinutes	integer	总年龄（以分钟为单位）。
带格式的年龄	formattedAge	string	人工可读格式化的年龄字符串。

WorkingHoursResponse

名称	路径	类型	说明
开始日期时间	startDateTime	date-time	计算中使用的开始日期和时间。
结束日期时间	endDateTime	date-time	计算中使用的结束日期和时间。
总小时数	totalHours	number	计算的总工作时间。
常规小时数	regularHours	number	常规工作时间（非加班）。
加班时间	overtimeHours	number	计算的加班小时数。
总天数	totalDays	integer	时间段内的日历天数总数。
工作日	workingDays	integer	总工作日（不包括周末）。

TimeZoneConversionResponse

名称	路径	类型	说明
原始日期时间	originalDateTime	date-time	提供的原始日期和时间。
转换后的日期时间	convertedDateTime	date-time	目标时区中的转换日期和时间。
从时区	fromTimeZone	string	使用的源时区。
时区	toTimeZone	string	使用的目标时区。
偏移差	offsetDifference	string	区域之间的时间差。
DST 活动	isDstActive	boolean	夏令时是否处于活动状态。

ProjectDurationResponse

名称	路径	类型	说明
开始日期	startDate	string	项目开始日期。
结束日期	endDate	string	项目结束日期。
日历天数总数	totalCalendarDays	integer	项目中的日历天数总数。
工作日总数	totalBusinessDays	integer	项目中的总工作日。
项目状态	projectStatus	string	当前项目状态评估。
里程碑分析	milestones	array of MilestoneAnalysis	分析的里程碑信息。
criticalPath	criticalPath	CriticalPath

MilestoneAnalysis

名称	路径	类型	说明
里程碑名称	name	string	里程碑名称。
里程碑日期	date	string	里程碑日期。
从头开始的天数	daysFromStart	integer	从项目开始到里程碑的天数。
结束日期	daysToEnd	integer	从里程碑到项目结束的天数。
完成百分比	percentComplete	number	在里程碑上完成的项目时间线的百分比。
逾期	isOverdue	boolean	里程碑是否过期。

CriticalPath

名称	路径	类型	说明
具有关键路径	hasCriticalPath	boolean	是否确定了关键里程碑。
关键里程碑	criticalMilestones	array of string	关键里程碑的名称。
建议的焦点	recommendedFocus	string	建议的项目成功重点区域。

DstValidationResponse

名称	路径	类型	说明
验证结果	validationResults	array of DstValidationResult	每个计算的验证结果。
总体符合性	overallCompliance	boolean	所有计算是否通过验证。
合规性分数	complianceScore	number	总体合规性分数（0-100）。
Recommendations	recommendations	array of string	修复验证问题的建议。

DstValidationResult

名称	路径	类型	说明
计算 ID	calculationId	string	计算标识符。
有效	isValid	boolean	计算是否有效。
actualResult	actualResult	DurationBreakdown
偏差	deviations	array of ValidationDeviation	与预期结果的偏差。
合规性问题	complianceIssues	array of string	发现符合性问题。

ValidationDeviation

名称	路径	类型	说明
领域	field	string	带偏差的字段。
预期	expected	string	期望值。
实际	actual	string	实际值。
Severity	severity	string	偏差的严重性。

TimeZoneInfoResponse

名称	路径	类型	说明
时区详细信息	timeZoneDetails	array of TimeZoneDetail	每个时区的详细信息。
比较	comparisons	array of TimeZoneComparison	时区之间的比较。

TimeZoneDetail

名称	路径	类型	说明
时区 ID	timeZoneId	string	时区标识符。
显示名称	displayName	string	人工可读时区名称。
当前偏移量	currentOffset	string	当前 UTC 偏移量。
标准偏移量	standardOffset	string	标准时间 UTC 偏移量。
夏令时制	isDaylightSaving	boolean	当前是否在夏令时。
dstRules	dstRules	DstRules
regionalInfo	regionalInfo	RegionalInfo

DstRules

名称	路径	类型	说明
使用 DST	usesDst	boolean	时区是否使用 DST。
Spring Forward 规则	springForwardRule	string	春季前向转换的规则。
回退规则	fallBackRule	string	回退转换的规则。
下一个转换	nextTransition	date-time	下一个 DST 转换日期。

RegionalInfo

名称	路径	类型	说明
国家/地区	countries	array of string	使用此时区的国家/地区。
主要城市	majorCities	array of string	此时区的主要城市。
政治地位	politicalStatus	string	DST 采用的政治地位。

TimeZoneComparison

名称	路径	类型	说明
时区 1	timeZone1	string	第一个时区。
时区 2	timeZone2	string	第二个时区。
偏移差	offsetDifference	string	区域之间的时间差。
相同的季节性模式	sameSeasonalPattern	boolean	区域是否遵循相同的 DST 模式。

DstTransitionResponse

名称	路径	类型	说明
时区	timeZone	string	分析的时区（IANA 时区）。
年份	year	integer	分析年份。
转换	transitions	array of DstTransition	年度的 DST 转换。
转换总数	totalTransitions	integer	转换总数。
impactAnalysis	impactAnalysis	DstImpactAnalysis

DstImpactAnalysis

名称	路径	类型	说明
受影响的小时数	affectedHours	integer	受转换影响的总小时数。
业务影响	businessImpact	string	评估的业务影响级别。
Recommendations	recommendations	array of string	处理转换的建议。
关键时段	criticalPeriods	array of CriticalPeriod	需要注意的关键时段。

CriticalPeriod

名称	路径	类型	说明
开始日期时间	startDateTime	date-time	关键时段的开始。
结束日期时间	endDateTime	date-time	关键期结束。
Description	description	string	关键时段的说明。
Severity	severity	string	严重性级别。

DstHistoryResponse

名称	路径	类型	说明
时区历史记录	timeZoneHistories	array of TimeZoneHistory	每个时区的 DST 历史记录。
摘要	summary	DstHistorySummary

TimeZoneHistory

名称	路径	类型	说明
时区	timeZone	string	时区标识符。
历史转换	historicalTransitions	array of HistoricalDstTransition	历史 DST 转换。
转换总数	totalTransitions	integer	记录的 DST 转换总数。
策略更改	policyChanges	array of DstPolicyChange	随着时间推移，DST 策略更改。

HistoricalDstTransition

名称	路径	类型	说明
年份	year	integer	过渡的年份。
转换类型	transitionType	string	DST 转换的类型。
转换日期	transitionDate	date-time	转换的日期和时间。
偏移更改	offsetChange	string	UTC 偏移量更改。
已应用规则	ruleApplied	string	已应用的 DST 规则。

DstPolicyChange

名称	路径	类型	说明
生效日期	effectiveDate	string	策略更改生效的日期。
更改说明	changeDescription	string	策略更改的说明。
原因	reason	string	策略更改的原因。
影响	impact	string	更改的影响级别。

DstHistorySummary

名称	路径	类型	说明
总时区	totalTimeZones	integer	分析的时区总数。
转换总数	totalTransitions	integer	跨所有时区的总转换。
最活跃的时区	mostActiveTimeZone	string	具有大多数 DST 更改的时区。
趋势	trends	array of string	观察到的 DST 趋势。
全局模式	globalPatterns	array of string	全球 DST 采用模式。

ParticipantLocalTime

名称	路径	类型	说明
参与者名称	participantName	string	参与者名称。
本地日期时间	localDateTime	date-time	参与者本地时区中的会议时间。
timeZone	timeZone	TimeZoneEnum	IANA 时区标识符。
在工作时间内	isWithinWorkingHours	boolean	时间是否在工作时间内。
冲突级别	conflictLevel	string	计划冲突级别。

PayrollPeriodsResponse

名称	路径	类型	说明
句点类型	periodType	string	计算的工资周期类型。
总周期数	totalPeriods	integer	工资周期总数。
完成周期	completePeriods	integer	完整的工资周期数。
部分时间段	partialPeriods	integer	部分工资周期数。
期间	periods	array of PayrollPeriod	包含详细信息的所有工资周期的列表。

PayrollPeriod

名称	路径	类型	说明
句点数	periodNumber	integer	工资周期的序列号。
开始日期	startDate	string	工资周期的开始日期。
结束日期	endDate	string	工资周期的结束日期。
工作日	workingDays	integer	在此期间的工作日数。
是部分	isPartial	boolean	这是否是部分时间段。

DeadlineCalculationResponse

名称	路径	类型	说明
截止时间日期	deadlineDate	date-time	目标截止时间日期和时间。
当前日期	currentDate	date-time	用于计算的当前日期。
剩余时间	timeRemaining	DurationBreakdown
剩余工作日	businessDaysRemaining	integer	剩余工作日数。
逾期到期	isPastDue	boolean	最后期限是否已通过。
严重状态	criticalStatus	string	截止时间时间线的状态。

CrossTzDurationResponse

名称	路径	类型	说明
开始日期时间 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 偏移量。

GlobalWorkingHoursResponse

名称	路径	类型	说明
总工作时间	totalWorkingHours	double	所有时区的总工作时间。
时区结果	timeZoneResults	array of object	按时区划分的工作时间细分。
时区	timeZoneResults.timeZone	string	时区标识符。
工作时间	timeZoneResults.workingHours	double	此时区的工作时间。
工作日	timeZoneResults.businessDays	integer	工作日数。
重叠小时数	overlapHours	double	所有时区都具有重叠工作时间的小时数。

MeetingTimesResponse

名称	路径	类型	说明
最佳时间	optimalTimes	array of object	按适用性排序的最佳会议时间列表。
开始时间	optimalTimes.startTime	date-time	会议开始时间（UTC）。
结束时间	optimalTimes.endTime	date-time	会议结束时间（UTC）。
适用性分数	optimalTimes.suitabilityScore	double	指示这次适合程度（0-100）的分数。
参与者时间	optimalTimes.participantTimes	array of ParticipantLocalTime	每个参与者的本地时间。
冲突	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	参与者之间的最长时间差异（以小时为单位）。

DurationBreakdown

名称	路径	类型	说明
总天数	totalDays	integer	总天数。
总小时数	totalHours	integer	总小时数。
总分钟数	totalMinutes	integer	总分钟数。
总秒数	totalSeconds	integer	总秒数。
年	years	integer	完整年数。
月数	months	integer	完成几年后再过几个月。
天数	days	integer	完成几个月后再过几天。
小时	hours	integer	完成几天后再多小时。
分钟	minutes	integer	完成数小时后再加几分钟。
秒	seconds	integer	完成几分钟后再几秒钟。

DstTransition

名称	路径	类型	说明
转换日期	transitionDate	date-time	发生 DST 转换的日期和时间。
时区	timeZone	string	发生转换的时区。
转换类型	transitionType	string	DST 转换的类型。
Offset Before	offsetBefore	string	切换前的 UTC 偏移量（例如“-05：00”）。
偏移后	offsetAfter	string	转换后的 UTC 偏移量（例如“-04：00”）。
时间调整	timeAdjustment	integer	时间调整以分钟为单位（春季前锋为+60，-60 回退）。

通过

参数

返回

参数

返回

参数

返回

参数

返回

参数

返回

参数

返回

参数

返回

参数

返回

参数

返回

参数

返回

参数

返回

参数

返回

参数

返回

参数

返回

通过

持续时间计算器 （独立发布者） （预览版）

限制

操作