getLocalTime

Web Services

getLocalTime

Get Time Zones and ISO 8601 times.

This function can be used in two different ways:
1) get Time Zones and ISO 8601 times for given UTC times and phone numbers
2) get Time Zones and ISO 8601 times for given UTC times and Time Zones
Time Zones support is provided by java SDK - some 600 time zones.
Note that ISO 8601 does not have daysavings offsets and historical dates of switching to daysavings time, so if you would like to do reliable calculations with times you should use UTC times (long number like 1258147131000) combined with Time Zone (like 'America/Los_Angeles'). More about time zones.

getLocalTimeRequest

Request to get time zones and ISO 8601 times.

Object Fields

Name	Type	Required	Description
wsAdmin	TdxAdmin	Yes	Admin Credentials
utcTimes	LongArray	Yes	UTC times (milliseconds from UTC 1970/01/01
ptns	StringArray	One and only one of ptns or timezones	Phone numbers
timezones	StringArray	One and only one of ptns or timezones	Time Zones i.e. America/Los_Angeles

XML Example:

<soapenv:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:urn="urn:tns" xmlns:soapenc="http://schemas.xmlsoap.org/soap/encoding/">
 <soapenv:Header/>
 <soapenv:Body>
  <urn:getLocalTime soapenv:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/">
   <wsAdmin xsi:type="sch:TdxAdmin" xmlns:sch="http://www.telenavtrack.net/schema">
    <email xsi:type="xsd:string">juan@telenav.com</email>
    <password xsi:type="xsd:string">hax4l0t</password>
   </wsAdmin>
   <utcTimes xsi:type="sch:LongArray" soapenc:arrayType="xsd:long[]" xmlns:sch="http://www.telenavtrack.net/schema">
    <utcTimes>1258501377031</utcTimes>
    <utcTimes>1258501377032</utcTimes>
   </utcTimes>
   <timezones xsi:type="sch:StringArray" soapenc:arrayType="xsd:string[]" xmlns:sch="http://www.telenavtrack.net/schema" xsi:nil="true"/>
   <ptns xsi:type="sch:StringArray" soapenc:arrayType="xsd:string[]" xmlns:sch="http://www.telenavtrack.net/schema">
    <ptns>5550000014</ptns>
    <ptns>5550000014</ptns>
   </ptns>
  </urn:getLocalTime>
 </soapenv:Body>
</soapenv:Envelope>

getLocalTimeResponse

Time Zones and ISO 8601 times.

Object Fields

Name	Type	Required	Description
timeZones	strings	Yes	Time Zones i.e. America/Los_Angeles.
dateTimes	dateTimes	Yes	ISO 8601 times.

XML Example:

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
 <soapenv:Body>
  <ns1:getLocalTimeResponse soapenv:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/" xmlns:ns1="urn:tns">
   <getLocalTimeReturn xsi:type="ns2:GetLocalTimeResponse" xmlns:ns2="http://www.telenavtrack.net/schema">
    <timeZones xsi:type="xsd:string">America/Los_Angeles</timeZones>
    <timeZones xsi:type="xsd:string">America/Los_Angeles</timeZones>
    <dateTimes xsi:type="xsd:dateTime">2009-11-17T15:42:57.031-08:00</dateTimes>
    <dateTimes xsi:type="xsd:dateTime">2009-11-17T15:42:57.032-08:00</dateTimes>
   </getLocalTimeReturn>
  </ns1:getLocalTimeResponse>
 </soapenv:Body>
</soapenv:Envelope>