nlfmtdate(3X)
NAME
nlfmtdate() − format MPE date and time in a localized format
SYNOPSIS
#include <portnls.h>
void nlfmtdate(
unsigned short int date,
unsigned long int time,
char *outstr,
short int langid,
unsigned short int err[2]
);
DESCRIPTION
nlfmtdate() formats the specified date and time in a localized custom version. For example:
SUN, FEB 7, 1988 9:00 AM
Arguments to nlfmtdate() are used as follows:
date An unsigned short indicating the date to be formatted in the packed date format:
| Bits | 0 | 6 | 7 | 15 |
| _ | _ | _ | _ | |
| Year of Century | Day of Year | |||
| _ | _ | _ | _ | |
time An unsigned int indicating the time to be formatted. The double word is in the clock format:
| Bits | 0 | 7 | 8 | 15 |
| _ | _ | _ | _ | |
| Hour of Day | Minute of Hour | |||
| _ | _ | _ | _ | |
| Bits | 16 | 23 | 24 | 31 |
| _ | _ | _ | _ | |
| Seconds | Tenths of Seconds | |||
| _ | _ | _ | _ | |
outstr A 28-byte buffer in which the formatted date is returned.
langid A short containing the language ID indicating the custom to be used.
err The first element of this array contains the error number. The second element is always zero. If the call is successful, both elements contain zero.
Error # Meaning
2 Specified language is not configured.
3 Invalid date format.
4 Invalid time format.
WARNINGS
This routine is provided for compatibility with MPE, a proprietary HP operating system. See portnls(5) for more information on the use of this routine. Use the Native Language Support routines for C programmers described by hpnls(5) for HP-UX NLS support.
AUTHOR
nlfmtdate() was developed by HP.
SEE ALSO
calendar(3X), clock(3X), nlfmtcal(3X), nlfmtclock(3X), portnls(5).
EXTERNAL INFLUENCES
International Code Set Support
Single- and multi-byte character code sets are supported.
Hewlett-Packard Company — HP-UX Release 9.0: August 1992