User Guide

36 Chapter 5: New FSCommand and FSCommand2 commands
Syntax
status = FSCommand2( "GetDateYear” )
Return value
A value of -1 if the function is not supported; otherwise, the current year, returned as a number
(for example, 2004).
GetLocaleLongDate()
The
GetLocaleLongDate() function sets a parameter to a string representing the current date, in
long form, formatted according to the currently defined locale. The parameter is passed in by
name. The value returned through it is a multiple-character, variable-length string. The actual
formatting depends on the mobile phone and the locale.
The
GetLocaleLongDate() function is executed immediately upon invocation. If this function is
not supported, a value of -1 is returned.
Syntax
status = FSCommand2( "GetLocaleLongDate”, "longdate" )
Return value
A value of -1 if the function is not supported; 0 if it’s supported.
Sample resultant values for
longdate:
October 16, 2004
16 October 2004
GetLocaleShortDate()
The
GetLocaleShortDate() function sets a parameter to a string representing the current date,
in abbreviated form, formatted according to the currently defined locale. The parameter is passed
in by name. The value returned is a multiple-character, variable-length string. The actual
formatting depends on the mobile phone and the locale.
The
GetLocaleShortDate() function is executed immediately upon invocation. If this function
is not supported, a value of -1 is returned.
Syntax
status = FSCommand2( "GetLocalShortDate”, "shortdate" )
Return value
A value of -1 if the function is not supported; 0 if it’s supported.
Sample resultant values for
shortdate:
10/16/2004
16-10-2004