Apple Newton Utilities Guide de l'utilisateur télécharger pdf (Page 743)

100

101

CHAPTER 20

Localizing Newton Applications

Using the Localization Features of the Newton 20-11

Functions that Use the Locale Setting To Determine Format 20

These functions are quite simple. You pass in a system clock value or a string, and

the function uses the date and time format information in the current locale bundle

to produce a string or a system clock value. Here are the functions of this type:

DateNTime(time)

HourMinute(time)

ShortDate(time)

StringToDate(dateString)

StringToTime(timeString)

For example:

DateNTime(Time());

Depending on the locale, this might return the string:

"04/17/1996 10:53am"

See the Newton Programmer’s Reference for more information on these functions.

Functions that Take Format Speciﬁcations 20

These functions take a time value and a string format speciﬁcation and return a

string formatted accordingly:

LongDateStr(time, dateStrSpec)

ShortDateStr(time, dateStrSpec)

TimeStr(time, timeStrSpec)

You can pass three kinds of format speciﬁcations:

■ You can use one of the pre-deﬁned format speciﬁcations in

ROM_dateTimeStrSpecs

■ You can use the GetDateStringSpec function to create a new format

speciﬁcation

■ You can use the kIncludeAllElements constant, which tells the functions

to use the format in the active locale

In all cases, the active locale bundle determines certain features of date and time

strings, speciﬁcally the order of elements and the separators used.

Using Formats from ROM_dateTimeStrSpecs 20

For commonly used format speciﬁcations, the system deﬁnes formats that can be

passed directly to the functions that accept format speciﬁcations. These formats are

stored in

ROM_dateTimeStrSpecs. See Table 17-5 (page 17-12) in Newton

Programmer’s Reference for the list of available formats.

1 2 ... 738 739 740 741 742 743 744 745 746 747 748 ... 941 942

Commentaires sur ces manuels

Pas de commentaire

Apple Newton Utilities Guide de l'utilisateur Page 743

Commentaires sur ces manuels

Produits connexes et manuels pour Logiciel Apple Newton Utilities