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
or
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
)
= 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
Bit#1 = 1: The indexed characters for digits [0…9], as defined via
, will be marked. The desired character set can be
.
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
(here, the parameter Mode will
be ignored). For marking as numerals, also Part = 6 or 7 can be used (then Mode is considered).