NAME

nlfmtcalendar() − format an MPE packed date using a localized format

SYNOPSIS

#include <portnls.h>

void nlfmtcalendar(

unsigned short int date,
char *outstr,
short int langid,
unsigned short int err[2]

);

DESCRIPTION

nlfmtcal() formats the specified date in the localized custom version of the date format, but with no time information (see nlfmtclock(3X)). For example:

FRI, OCT 2, 1987

Arguments to nlfmtcal() are used as follows:

date An unsigned short indicating the date in the packed date format:

outstr A character buffer in which the formatted date is returned.  This buffer is 18 bytes long, and padded with blanks if necessary. 

langid A short integer specifying the language whose custom is 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. 

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

nlfmtcal() was developed by HP. 

SEE ALSO

calendar(3X), portnls(5). 

EXTERNAL INFLUENCES

International Code Set Support

Single- and multi-byte character code sets are supported. 

Hewlett-Packard Company  —  HP-UX Release 10.20:  July 1996