Compartilhar via


TimeAPI (Independent Publisher) (Preview)

Accurate and reliable time information for any location in the world. Say goodbye to time zone confusion and hello to easy time tracking with our service.

This connector is available in the following products and regions:

Service Class Regions
Logic Apps Standard All Logic Apps regions except the following:
     -   Azure Government regions
     -   Azure China regions
     -   US Department of Defense (DoD)
Power Automate Premium All Power Automate regions except the following:
     -   US Government (GCC)
     -   US Government (GCC High)
     -   China Cloud operated by 21Vianet
     -   US Department of Defense (DoD)
Power Apps Premium All Power Apps regions except the following:
     -   US Government (GCC)
     -   US Government (GCC High)
     -   China Cloud operated by 21Vianet
     -   US Department of Defense (DoD)
Contact
Name Fördős András
Email fordosa90+timeapi@gmail.com
Connector Metadata
Publisher Fördős András
Website https://timeapi.io/
Privacy policy https://timeapi.io/home/faqs
Categories Data;Business Intelligence

Throttling Limits

Name Calls Renewal Period
API calls per connection 100 60 seconds

Actions

Convert time

Allows you to convert the time in a timezone to the time in another timezone.

Convert to day

Convert a date to the day of the week.

Decrement by timespan

Allows you to decrement a custom datetime by a specific timespan.

Get current time

Gets the current time of a time zone.

Get current time (by coordinates)

Gets the current time of a time zone by geo coordinates.

Get current time (by IP)

Gets the current time of a time zone by ip address.

Get time zone

Gets the time zone info by IANA time zone name.

Get time zone (by coordinates)

Gets the time zone info of a geo coordinate.

Get time zone (by IP)

Gets the time zone info of an IPv4 address.

Increment by timespan

Allows you to increment a custom datetime by a specific timespan.

List time zones

Gets all the available IANA time zones.

Localize time

Converts a date time into a language translated friendly date time string.

Convert time

Allows you to convert the time in a timezone to the time in another timezone.

Parameters

Name Key Required Type Description
From time zone
fromTimeZone True string

IANA TimeZonetime zone, for example 'Europe/Budapest'.

Date time
dateTime True string

DateTime in format: yyyy-MM-dd HH:mm:ss or in format: yyyy-MM-dd HH:mm:ss.ffffff.

toTimeZone
toTimeZone True string

IANA time zone, e.g.: 'Europe/Budapest'.

DST ambiguity
dstAmbiguity True string

Sometimes a time can be ambiguous due to DST switching overnight, e.g.: '01:30' happens twice in same day.

Returns

Body
Conversion

Convert to day

Convert a date to the day of the week.

Parameters

Name Key Required Type Description
Date
date True string

Date in format: yyyy-MM-dd.

Returns

Decrement by timespan

Allows you to decrement a custom datetime by a specific timespan.

Parameters

Name Key Required Type Description
Time zone
timeZone True string

IANA time zone, e.g.: 'Europe/Budapest'.

Date time
dateTime True string

DateTime in format: yyyy-MM-dd HH:mm:ss or in format: yyyy-MM-dd HH:mm:ss.ffffff.

Time span
timeSpan True string

Time span to increase or decrease datetime by in format: d:hh:mm:ss or in format: d:hh:mm:ss.fff.

DST ambiguity
dstAmbiguity True string

Sometimes a time can be ambiguous due to DST switching overnight, for example '01:30' happening twice.

Returns

Get current time

Gets the current time of a time zone.

Parameters

Name Key Required Type Description
Time zone
timeZone True string

Full IANA time zone name, for example 'Europe/Budapest'.

Returns

Get current time (by coordinates)

Gets the current time of a time zone by geo coordinates.

Parameters

Name Key Required Type Description
Latitude
latitude True float

Latitude ranging from -90 to 90.

Longitude
longitude True float

Longitude ranging from -180 to 180.

Returns

Get current time (by IP)

Gets the current time of a time zone by ip address.

Parameters

Name Key Required Type Description
IPv4
ipAddress True string

IPv4 address.

Returns

Get time zone

Gets the time zone info by IANA time zone name.

Parameters

Name Key Required Type Description
Time zone
timeZone True string

Full IANA time zone name, for example: 'Europe/Budapest'.

Returns

Time zone details.

Time zone
TimeZoneData

Get time zone (by coordinates)

Gets the time zone info of a geo coordinate.

Parameters

Name Key Required Type Description
Latitude
latitude True float

Latitude ranging from -90 to 90.

Longitude
longitude True float

Longitude ranging from -180 to 180.

Returns

Time zone details.

Time zone
TimeZoneData

Get time zone (by IP)

Gets the time zone info of an IPv4 address.

Parameters

Name Key Required Type Description
IPv4
ipAddress True string

IPv4 address.

Returns

Time zone details.

Time zone
TimeZoneData

Increment by timespan

Allows you to increment a custom datetime by a specific timespan.

Parameters

Name Key Required Type Description
Time zone
timeZone True string

IANA time zone, e.g.: 'Europe/Budapest'.

Date time
dateTime True string

DateTime in format: yyyy-MM-dd HH:mm:ss or in format: yyyy-MM-dd HH:mm:ss.ffffff.

Time span
timeSpan True string

Time span to increase or decrease datetime by in format: d:hh:mm:ss or in format: d:hh:mm:ss.fff.

DST ambiguity
dstAmbiguity True string

Sometimes a time can be ambiguous due to DST switching overnight, for example '01:30' happening twice.

Returns

List time zones

Gets all the available IANA time zones.

Returns

Name Path Type Description
Time zones
array of string

Array of available time zones.

Localize time

Converts a date time into a language translated friendly date time string.

Parameters

Name Key Required Type Description
Date time
dateTime True string

DateTime in format: yyyy-MM-dd HH:mm:ss or in format: yyyy-MM-dd HH:mm:ss.ffffff.

Language code
languageCode True string

2 letter ISO 639-1 language code, e.g.: 'de'.

Returns

Translation details.

Translation
Translation

Definitions

Calculation

Name Path Type Description
Time zone
timeZone string

IANA Timezone used, e.g.: 'Europe/Budapest'.

Original DateTime
originalDateTime date-time

Original DateTime used as input.

Original timespan
usedTimeSpan string

The timespan used to increase or decrease the original datetime by in format: d:hh:mm:ss.

Calculation results
calculationResult CalculationResult

Output from the calculation request.

CalculationResult

Output from the calculation request.

Name Path Type Description
Year
year integer

Year, for example '2021'.

Month
month integer

Month, for example '12'.

Day
day integer

Day, for example '13'.

Hour
hour integer

Hour of the day in range 0-24.

Minute
minute integer

Minute.

Second
seconds integer

Second.

Milliseconds
milliSeconds integer

Milliseconds.

Date time
dateTime date-time

Full date time.

Date
date string

Date string, in format: DD/MM/YYYY.

Time
time string

Time string.

Is DST active
dstActive boolean

Boolean describing whether DST is applied and active in that timezone.

Conversion

Name Path Type Description
From time zone
fromTimezone string

Source time zone for the conversion.

From DateTime
fromDateTime date-time

Source date time for the conversion.

To time zone
toTimeZone string

Target time zone of the conversion.

Conversion results
conversionResult ConversionResult

Output from the conversion request.

ConversionResult

Output from the conversion request.

Name Path Type Description
Year
year integer

Year.

Month
month integer

Month.

Day
day integer

Day.

Hour
hour integer

Hour of the day in range 0-24.

Minute
minute integer

Minute.

Second
seconds integer

Second.

Milliseconds
milliSeconds integer

Milliseconds.

DateTime
dateTime date-time

Full date time.

Date
date string

Date string.

Time
time string

Time string.

Time zone
timeZone string

Time zone of the result.

Is DST active
dstActive boolean

Boolean describing whether DST is applied and active in that time zone.

CurrentTime

Name Path Type Description
Year
year integer

Year.

Month
month integer

Month.

Day
day integer

Day.

Hour
hour integer

Hour of the day in range 0-24.

Minute
minute integer

Minute.

Seconds
seconds integer

Seconds.

Milliseconds
milliSeconds integer

Milliseconds.

Date time
dateTime date-time

Full date time.

Date
date string

Date string.

Time
time string

Time string.

Time zone
timeZone string

Time zone of the result, e.g.: 'Europe/Budapest'

Day of week
dayOfWeek DayOfWeek

Day of week as string, e.g.: 'Sunday'.

DST active
dstActive boolean

Boolean describing whether DST is applied and active in that time zone.

DayOfTheWeekResult

Name Path Type Description
Day of week
dayOfWeek DayOfWeek

Day of week as string, e.g.: 'Sunday'.

DayOfWeek

Day of week as string, e.g.: 'Sunday'.

Day of week as string, e.g.: 'Sunday'.

Day of week
string

DstInterval

Details of DST interval.

Name Path Type Description
Name
dstName string

Name of DST.

Offset
dstOffsetToUtc Offset

Details of offset.

Offset
dstOffsetToStandardTime Offset

Details of offset.

Start
dstStart date-time

Start of DST interval.

End
dstEnd date-time

End of DST interval.

Duration
dstDuration Duration

Details of the duration.

Duration

Details of the duration.

Name Path Type Description
Days
days integer

Duration days.

Nanosecond of day
nanosecondOfDay integer

Nanosecond of day.

Hours
hours integer

Hours.

Minutes
minutes integer

Minutes.

Seconds
seconds integer

Seconds.

Milliseconds
milliseconds integer

Milliseconds.

Subsecond tick
subsecondTicks integer

Subsecond tick.

Subsecond nanoseconds
subsecondNanoseconds integer

Subsecond nanoseconds.

BCL compatible ticks
bclCompatibleTicks integer

BCL compatible ticks.

Total days
totalDays double

Total days.

Total hours
totalHours double

Total hours.

Total minutes
totalMinutes double

Total minutes.

Total seconds
totalSeconds double

Total seconds.

Total milliseconds
totalMilliseconds double

Total milliseconds.

Total ticks
totalTicks double

Total ticks.

Total nanoseconds
totalNanoseconds double

Total nanoseconds.

Offset

Details of offset.

Name Path Type Description
Seconds
seconds integer

Seconds.

Milliseconds
milliseconds integer

Milliseconds.

Ticks
ticks integer

Ticks.

Nanoseconds
nanoseconds integer

Nanoseconds.

TimeZoneData

Time zone details.

Name Path Type Description
Name
timeZone string

Name of the time zone.

Current time
currentLocalTime date-time

Current local time.

Offset
currentUtcOffset Offset

Details of offset.

Offset
standardUtcOffset Offset

Details of offset.

Has DST
hasDayLightSaving boolean

Indication, whether time zone has DST.

Is DST active
isDayLightSavingActive boolean

Indication, whether DST is currently active.

DST interval
dstInterval DstInterval

Details of DST interval.

Translation

Translation details.

Name Path Type Description
Date time
dateTime string

Given date time to translate, e.g.: '2021-03-14 17:45:00'.

Language code
languageCode string

Given language code to translate the date time into, e.g.: 'de'.

Friendly date time
friendlyDateTime string

Full translated date time.

Friendly date
friendlyDate string

Translated date.

Time
friendlyTime string

Translated time.