 |
LOC_formatDate |
Function (ROM Call 0x590) |
Formats a date into date according to format string.
format: string containing date specifiers:
D : One- or two-digit day of month.
DD : Two-digit day of month (leading zero if necessary).
M : One- or two-digit month.
MM : Two-digit month (leading zero if necessary).
YY : Two-digit year (year without century).
YYYY : Four-digit year.
Any other characters are copied to output.
y : Year.
m : Month.
d : Day of month.
Examples:
char date[16];
short y = 2000, m = 6, d = 9;
LOC_formatDate("M/D/YYYY", y, m, d, date); // 6/9/2000
LOC_formatDate("MM/DD/YYYY", y, m, d, date); // 06/09/2000
LOC_formatDate("YYYY.MM.DD", y, m, d, date); // 2000.06.09
LOC_formatDate("D-M-YY", y, m, d, date); // 9-6-00
LOC_formatDate("MM/YYYY", y, m, d, date); // 06/2000
The ROM_CALL LOC_formatDate is available only on AMS 2.02 and higher.
Note: LOC_formatDate doesn't check the parameters, as you'll see if you try:
LOC_formatDate("MM/DD/YYYY",32767,32767,32767,buffer);
if buffer is large enough.
Uses: sprintf
Used by: LOC_localVersionDate
See also: LOC_getLocalDateFormat, LOC_localVersionDate