TimeAPI （独立发布者） （预览版）

世界上任何位置的准确可靠的时间信息。 告别时区混乱，你好用我们的服务轻松跟踪时间。

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

服务	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	Fördás András
Email	fordosa90+timeapi@gmail.com

连接器元数据
发布者	Fördás András
网站	https://timeapi.io/
隐私策略	https://timeapi.io/home/faqs
类别	数据;商业智能

限制

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

操作

列出时区	获取所有可用的 IANA 时区。
按时间跨度递减	允许按特定时间跨度递减自定义日期时间。
按时间跨度递增	允许按特定时间跨度递增自定义日期时间。
本地化时间	将日期时间转换为语言翻译的友好日期时间字符串。
获取当前时间	获取时区的当前时间。
获取当前时间（按 IP）	按 IP 地址获取时区的当前时间。
获取当前时间（按坐标）	按地理坐标获取时区的当前时间。
获取时区	按 IANA 时区名称获取时区信息。
获取时区（按 IP）	获取 IPv4 地址的时区信息。
获取时区（按坐标）	获取地理坐标的时区信息。
转换为日期	将日期转换为星期几。
转换时间	允许将时区中的时间转换为另一时区中的时间。

列出时区

操作 ID:

ListTimezones

获取所有可用的 IANA 时区。

返回

名称	路径	类型	说明
时区		array of string	可用时区的数组。

按时间跨度递减

操作 ID:

DecrementByTimespan

允许按特定时间跨度递减自定义日期时间。

参数

名称	密钥	必需	类型	说明
时区	timeZone	True	string	IANA 时区，例如：“欧洲/布达佩斯”。
日期时间	dateTime	True	string	采用格式的 DateTime：yyyy-MM-dd HH：mm：ss 或格式：yyyy-MM-dd HH：mm：ss.ffffff。
时间跨度	timeSpan	True	string	按格式增加或减少日期时间的时间跨度：d：hh：mm：ss 或格式：d：hh：mm：ss.fff。
DST 歧义性	dstAmbiguity	True	string	有时，由于 DST 在夜间切换，例如“01：30”发生两次，有时时间可能不明确。

返回

Body

Calculation

按时间跨度递增

操作 ID:

IncrementByTimespan

允许按特定时间跨度递增自定义日期时间。

参数

名称	密钥	必需	类型	说明
时区	timeZone	True	string	IANA 时区，例如：“欧洲/布达佩斯”。
日期时间	dateTime	True	string	采用格式的 DateTime：yyyy-MM-dd HH：mm：ss 或格式：yyyy-MM-dd HH：mm：ss.ffffff。
时间跨度	timeSpan	True	string	按格式增加或减少日期时间的时间跨度：d：hh：mm：ss 或格式：d：hh：mm：ss.fff。
DST 歧义性	dstAmbiguity	True	string	有时，由于 DST 在夜间切换，例如“01：30”发生两次，有时时间可能不明确。

返回

Body

Calculation

本地化时间

操作 ID:

LocalizeTime

将日期时间转换为语言翻译的友好日期时间字符串。

参数

名称	密钥	必需	类型	说明
日期时间	dateTime	True	string	采用格式的 DateTime：yyyy-MM-dd HH：mm：ss 或格式：yyyy-MM-dd HH：mm：ss.ffffff。
语言代码	languageCode	True	string	2 个字母 ISO 639-1 语言代码，例如：“de”。

返回

翻译详细信息。

翻译

Translation

获取当前时间

操作 ID:

GetCurrentTime

获取时区的当前时间。

参数

名称	密钥	必需	类型	说明
时区	timeZone	True	string	完整的 IANA 时区名称，例如“欧洲/布达佩斯”。

返回

Body

CurrentTime

获取当前时间（按 IP）

操作 ID:

GetCurrentTimeByIp

按 IP 地址获取时区的当前时间。

参数

名称	密钥	必需	类型	说明
IPv4	ipAddress	True	string	IPv4 地址。

返回

Body

CurrentTime

获取当前时间（按坐标）

操作 ID:

GetCurrentTimeByTimezone

按地理坐标获取时区的当前时间。

参数

名称	密钥	必需	类型	说明
Latitude	latitude	True	float	从 -90 到 90 的纬度。
Longitude	longitude	True	float	从 -180 到 180 的经度。

返回

Body

CurrentTime

获取时区

操作 ID:

GetTimezone

按 IANA 时区名称获取时区信息。

参数

名称	密钥	必需	类型	说明
时区	timeZone	True	string	完整的 IANA 时区名称，例如：“欧洲/布达佩斯”。

返回

时区详细信息。

时区

TimeZoneData

获取时区（按 IP）

操作 ID:

GetTimezoneByIp

获取 IPv4 地址的时区信息。

参数

名称	密钥	必需	类型	说明
IPv4	ipAddress	True	string	IPv4 地址。

返回

时区详细信息。

时区

TimeZoneData

获取时区（按坐标）

操作 ID:

GetTimezoneByCoordinate

获取地理坐标的时区信息。

参数

名称	密钥	必需	类型	说明
Latitude	latitude	True	float	从 -90 到 90 的纬度。
Longitude	longitude	True	float	从 -180 到 180 的经度。

返回

时区详细信息。

时区

TimeZoneData

转换为日期

操作 ID:

ConvertTimeToDay

将日期转换为星期几。

参数

名称	密钥	必需	类型	说明
日期	date	True	string	格式的日期：yyyy-MM-dd。

返回

Body

DayOfTheWeekResult

转换时间

操作 ID:

ConvertTime

允许将时区中的时间转换为另一时区中的时间。

参数

名称	密钥	必需	类型	说明
从时区	fromTimeZone	True	string	IANA TimeZonetime 区域，例如“欧洲/布达佩斯”。
日期时间	dateTime	True	string	采用格式的 DateTime：yyyy-MM-dd HH：mm：ss 或格式：yyyy-MM-dd HH：mm：ss.ffffff。
toTimeZone	toTimeZone	True	string	IANA 时区，例如：“欧洲/布达佩斯”。
DST 歧义性	dstAmbiguity	True	string	有时，由于 DST 隔夜切换，有时时间可能不明确，例如：“01：30”在同一天发生两次。

返回

Body

Conversion

定义

计算

名称	路径	类型	说明
时区	timeZone	string	IANA 时区使用，例如：“欧洲/布达佩斯”。
原始 DateTime	originalDateTime	date-time	用作输入的原始 DateTime。
原始时间跨度	usedTimeSpan	string	用于按格式增加或减少原始日期时间的时间跨度：d：hh：mm：ss。
计算结果	calculationResult	CalculationResult	计算请求的输出。

CalculationResult

计算请求的输出。

名称	路径	类型	说明
年份	year	integer	年份，例如“2021”。
月份	month	integer	月份，例如“12”。
星期	day	integer	Day，例如“13”。
小时	hour	integer	0-24 范围内的一天中的小时。
Minute	minute	integer	分钟。
Second	seconds	integer	第二。
毫秒	milliSeconds	integer	毫秒。
日期时间	dateTime	date-time	完整日期时间。
日期	date	string	日期字符串，格式为：DD/MM/YYYY。
Time	time	string	时间字符串。
DST 处于活动状态	dstActive	boolean	描述 DST 是否在时区中应用并处于活动状态的布尔值。

Conversion

名称	路径	类型	说明
从时区	fromTimezone	string	转换的源时区。
从 DateTime	fromDateTime	date-time	转换的源日期时间。
时区	toTimeZone	string	转换的目标时区。
转换结果	conversionResult	ConversionResult	转换请求的输出。

ConversionResult

转换请求的输出。

名称	路径	类型	说明
年份	year	integer	年。
月份	month	integer	月。
星期	day	integer	日。
小时	hour	integer	0-24 范围内的一天中的小时。
Minute	minute	integer	分钟。
Second	seconds	integer	第二。
毫秒	milliSeconds	integer	毫秒。
日期和时间	dateTime	date-time	完整日期时间。
日期	date	string	日期字符串。
Time	time	string	时间字符串。
时区	timeZone	string	结果的时区。
DST 处于活动状态	dstActive	boolean	描述 DST 是否在该时区中应用并处于活动状态的布尔值。

CurrentTime

名称	路径	类型	说明
年份	year	integer	年。
月份	month	integer	月。
星期	day	integer	日。
小时	hour	integer	0-24 范围内的一天中的小时。
Minute	minute	integer	分钟。
秒	seconds	integer	秒。
毫秒	milliSeconds	integer	毫秒。
日期时间	dateTime	date-time	完整日期时间。
日期	date	string	日期字符串。
Time	time	string	时间字符串。
时区	timeZone	string	结果的时区，例如：“欧洲/布达佩斯”
星期几	dayOfWeek	DayOfWeek	星期几作为字符串，例如：“星期日”。
DST 处于活动状态	dstActive	boolean	描述 DST 是否在该时区中应用并处于活动状态的布尔值。

DayOfTheWeekResult

名称	路径	类型	说明
星期几	dayOfWeek	DayOfWeek	星期几作为字符串，例如：“星期日”。

星期几

星期几作为字符串，例如：“星期日”。

星期几作为字符串，例如：“星期日”。

星期几

string

DstInterval

DST 间隔的详细信息。

名称	路径	类型	说明
Name	dstName	string	DST 的名称。
Offset	dstOffsetToUtc	Offset	偏移的详细信息。
Offset	dstOffsetToStandardTime	Offset	偏移的详细信息。
Start	dstStart	date-time	DST 间隔的开始时间。
结束	dstEnd	date-time	DST 间隔结束。
持续时间	dstDuration	Duration	持续时间的详细信息。

持续时间

持续时间的详细信息。

名称	路径	类型	说明
天数	days	integer	持续时间天数。
当天的 Nanosecond	nanosecondOfDay	integer	当天的纳秒数。
小时	hours	integer	小时。
分钟	minutes	integer	纪要。
秒	seconds	integer	秒。
毫秒	milliseconds	integer	毫秒。
次秒刻度	subsecondTicks	integer	次秒刻度。
Subsecond nanoseconds	subsecondNanoseconds	integer	Subsecond nanoseconds。
BCL 兼容的时钟周期	bclCompatibleTicks	integer	BCL 兼容的时钟周期。
总天数	totalDays	double	总天数。
总小时数	totalHours	double	总小时数。
总分钟数	totalMinutes	double	总分钟数。
总秒数	totalSeconds	double	总秒数。
总毫秒数	totalMilliseconds	double	总毫秒数。
总时钟周期数	totalTicks	double	总时钟周期数。
总纳秒数	totalNanoseconds	double	总纳秒数。

Offset

偏移的详细信息。

名称	路径	类型	说明
秒	seconds	integer	秒。
毫秒	milliseconds	integer	毫秒。
蜱	ticks	integer	蜱。
纳 秒	nanoseconds	integer	纳 秒。

TimeZoneData

时区详细信息。

名称	路径	类型	说明
Name	timeZone	string	时区的名称。
当前时间	currentLocalTime	date-time	当前本地时间。
Offset	currentUtcOffset	Offset	偏移的详细信息。
Offset	standardUtcOffset	Offset	偏移的详细信息。
具有 DST	hasDayLightSaving	boolean	指示时区是否具有 DST。
DST 处于活动状态	isDayLightSavingActive	boolean	指示 DST 当前是否处于活动状态。
DST 间隔	dstInterval	DstInterval	DST 间隔的详细信息。

翻译

翻译详细信息。

名称	路径	类型	说明
日期时间	dateTime	string	给定的翻译日期时间，例如：“2021-03-14 17：45：00”。
语言代码	languageCode	string	用于将日期时间翻译为的给定语言代码，例如：“de”。
友好日期时间	friendlyDateTime	string	完全翻译的日期时间。
友好日期	friendlyDate	string	已翻译的日期。
Time	friendlyTime	string	翻译的时间。