Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Register parameters

Code Block
titleRST 20H, DEFW $8009
 
IN:
A = desired string with
     A7 = 1 get day of the week


     A6 = 1 get month name


     A5 = 0 full string, 1 short string


     A4 = 0 get moment (no short string available)


     A0-A3 day of the week from 1-7 (Monday-Sunday)


           or month name 1-12 (January_December)


           or moment : 1=today, 2=yesterday, 3=tomorrow



HL = Destination buffer (at least 16 bytes required)


     HL has to be in segment 2 or 3



OUT, if call successful:
     Fc = 0
     HL = null terminated string desired


     DE = zero at the end of the string


     B = number of characters written to buffer (except trailing zero)




OUT, if call failed:
     Fc = 1
     A = error code
 
Registers changed after return:
     

     Fc = 1
     A = error code
 
Registers changed after return:
     ...C..HL/IXIY
same     
 same
     AFB.DEHL/....
different  
 different 

 

Notes

The call is useful to get country localized full or short string of day of the week or month name. An example of the usage can be read in Calendar popdown source code.

The localized string of 'Today, Yesterday or Tomorrow' is available. It is used by GN_Sdo to output today instead of formatted date as seen in Index application.

The buffer on entry has to be in segment 2 or 3, segment is used by the Date Filter Definition Table (FDT).

Bugs
 

-

Related calls

GN_Dei, convert zoned format date to internal format 
GN_Die, convert internal format date to zoned format 
GN_Gdt, convert an ASCII string to an internal binary date
GN_Pdn, write number as decimal ASCII string
GN_Gmd, Get (read) machine date in internal format 
GN_Pmd, put (set) machine date