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:
     ...C..HL/IXIY same
     AFB.DEHL/.... 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 1 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