Versions Compared

Old Version 4

changes.mady.by.user Elpekos

Saved on

compared with

New Version 5

changes.mady.by.user Elpekos

Saved on

Key

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

Register parameters

RST 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 always 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 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