TimeAPI (Independent Publisher) (Preview)

  • Reference

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

Operation ID:
ConvertTime

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

Operation ID:
ConvertTimeToDay

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

Body
DayOfTheWeekResult

Decrement by timespan

Operation ID:
DecrementByTimespan

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

Body
Calculation

Get current time

Operation ID:
GetCurrentTime

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

Body
CurrentTime

Get current time (by coordinates)

Operation ID:
GetCurrentTimeByTimezone

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

Body
CurrentTime

Get current time (by IP)

Operation ID:
GetCurrentTimeByIp

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

Parameters

Name Key Required Type Description
IPv4
 ipAddress True string

IPv4 address.

Returns

Body
CurrentTime

Get time zone

Operation ID:
GetTimezone

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)

Operation ID:
GetTimezoneByCoordinate

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)

Operation ID:
GetTimezoneByIp

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

Operation ID:
IncrementByTimespan

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

Body
Calculation

List time zones

Operation ID:
ListTimezones

Gets all the available IANA time zones.

Returns

Name Path Type Description
Time zones
 array of string

Array of available time zones.

Localize time

Operation ID:
LocalizeTime

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.