Newton Developer Technical Information: Newton Programmer's Guide: 2.1 OS Addendum /

Chapter 11 - Miscellaneous / Reference

Functions and Methods / Utility Functions

LocalTime

LocalTime(time, where)

Returns the local time in a distant city.

time

An integer, the time in minutes since 1/1/1904 in the local, Newton device's, time zone. This is the value returned by the Time function.

where

A city entry, as returned by GetCityEntry.

return value

An integer, the time in minutes since 1/1/1904 in the where city, adjusted as necessary for time zone and daylight savings.

DISCUSSION

To find out the time in Tokyo:

 Date(LocalTime(Time(), GetCityEntry("Tokyo")[0])) 

This function call returns the following frame

 {year: 1997, month: 2, Date: 22, dayOfWeek: 6, hour: 8, minute: 1, second: 0, daysInMonth: 28}

COMPATIBILITY

This function exists in Newton 2.0 OS, but was not previously documented.