Scanlab RTC 5 PC Interface Board - mark_date

RTC
®
5 PC Interface Board
Rev. 1.9 e
10 Commands And Functions
353
innovators for industry
Normal
List Command
mark_date
Function marks a part of the date previously stored via time_fix, time_fix_f or time_fix_f_off in the
selected format at the current position.
Call mark_date( Part, Mode )
Parameters Part this parameter (unsigned 32-bit value, allowed range: [0 … 7]) specifies
which part of the date should be marked:
= 0: year (only the last two digits)
= 1: month (in customer specific notation)
= 2: day (corresponding to the normal Gregorian date)
= 3: day-of-the-week (in customer specific notation)
= 4: Julian day (also see time_fix_f_off)
= 5: year (four digits)
= 6: month as numerals (January = 1, …)
= 7: day-of-the-week as numerals (Sunday = 1, …)
Mode Selection of the format as an unsigned 32-bit value (allowed range: [0 … 3]):
a) The number of leading zeros in the day number (only affects Part = 2, 4,
6 or 7):
Bit#0 = 0: leading zeros are suppressed.
Bit#0 = 1: day of the month (
Part = 2), always two digits,
day of the year (
Part = 4), always three digits,
month (
Part = 6), always two digits,
day-of-the-week (
Part = 7), always two digits.
b) Desired character set for marking digits (only affects
Part = 0, 2 or 4 … 7):
Bit#1 = 0: The indexed text string for digits [0…9], as defined via
load_text_table or set_text_table_pointer, will be marked.
Bit#1 = 1: The indexed characters for digits [0…9], as defined via load_char
or set_char_pointer, will be marked. The desired character set can be
specified with select_char_set.
For Part = 1 or 3, days of the month or days of the week are marked via indexed text strings (Index
= 10…28) defined with load_text_table or set_text_table_pointer (here, the parameter Mode will
be ignored). For marking as numerals, also Part = 6 or 7 can be used (then Mode is considered).