View as Markdown
IPGeolocation icon

IPGeolocation ACTION

Convert Timezone

Convert a time between two timezones using timezone names, coordinates, city, IATA, ICAO, or UN/LOCODE. See the documentation
  • Action
  • Read only
  • API key
  • SDK
  • MCP

IMPLEMENTATION

Call this tool

Connect a user's IPGeolocation account once, then configure and run Convert Timezone from your backend or agent.

import { PipedreamClient } from "@pipedream/sdk"

const pd = new PipedreamClient({
  projectId: process.env.PIPEDREAM_PROJECT_ID!,
  clientId: process.env.PIPEDREAM_CLIENT_ID!,
  clientSecret: process.env.PIPEDREAM_CLIENT_SECRET!,
  projectEnvironment: "production",
})

const result = await pd.actions.run({
  id: "ipgeolocation-convert-timezone",
  externalUserId: "{external_user_id}", // any stable ID for this user in your system
  configuredProps: {
    ipgeolocation: { authProvisionId: "apn_xxxxxxx" },
    tzFrom: "From Timezone",
    tzTo: "To Timezone",
  },
})

console.log(result)

SCHEMA

Inputs

Pipedream supplies the connected account. Your application provides the operation-specific values below. Dynamic inputs are resolved against that user's account.

Convert Timezone inputs
Property Type Description
tzFrom From Timezone string
Source timezone name (e.g. America/New_York). Must be used with To Timezone
Optional
tzTo To Timezone string
Target timezone name (e.g. Asia/Tokyo). Must be used with From Timezone
Optional
latFrom From Latitude string
Source latitude coordinate. Must be used with From Longitude
Optional
longFrom From Longitude string
Source longitude coordinate. Must be used with From Latitude
Optional
latTo To Latitude string
Target latitude coordinate. Must be used with To Longitude
Optional
longTo To Longitude string
Target longitude coordinate. Must be used with To Latitude
Optional
locationFrom From Location string
Source city or address (e.g. New York, USA). Must be used with To Location
Optional
locationTo To Location string
Target city or address (e.g. London, UK). Must be used with From Location
Optional
iataFrom From IATA Code string
Source airport IATA code (e.g. JFK). Must be used with To IATA Code
Optional
iataTo To IATA Code string
Target airport IATA code (e.g. LHR). Must be used with From IATA Code
Optional
icaoFrom From ICAO Code string
Source airport ICAO code (e.g. KJFK). Must be used with To ICAO Code
Optional
icaoTo To ICAO Code string
Target airport ICAO code (e.g. EGLL). Must be used with From ICAO Code
Optional
locodeFrom From UN/LOCODE string
Source UN/LOCODE (e.g. USNYC). Must be used with To UN/LOCODE
Optional
locodeTo To UN/LOCODE string
Target UN/LOCODE (e.g. GBLON). Must be used with From UN/LOCODE
Optional
time Time to Convert string
Time to convert in format YYYY-MM-DD HH:mm or YYYY-MM-DD HH:mm:ss. Leave blank to convert current time
Optional

REFERENCE

Tool details

Behavior hints are published with the component in the Pipedream registry and surface as MCP tool annotations, so an agent can reason about a tool before it calls it.

Registry key
ipgeolocation-convert-timezone
Version
0.0.2
App
IPGeolocation
Authentication
API key
Read-only
Yes
Destructive
No
Open world
Yes