nl_cxtime(S)                   6 January 1993                   nl_cxtime(S)


 Name

    nl_cxtime, nl_ascxtime - format date and time

 Syntax


    cc ... -lintl


    #include <time.h>

    char *nl_cxtime (clock, format)
    long *clock;
    char *format;

    char *nl_ascxtime (tm, format)
    struct tm *tm;
    char *format;


 Description

    The routines nlcxtime and nlascxtime provide an alternative interface
    to the ctime(S) routines for programs written to the X/OPEN Portability
    Guide standard.  However, both nlcxtime and nlascxtime have been with-
    drawn from XPG3.

    They provide the same functions as the ctime(S) routines ctime and asc-
    time, except that a strftime(S) format string is provided to determine
    the layout of the resulting string.

    The  X/OPEN Portability Guide permits the following field descriptors
    only:

    n   insert a newline character
    t   insert a tab character
    m   month of year - 01 to 12
    d   day of month - 01 to 31
    y   last 2 digits of year - 00 to 99
    D   date as mm/dd/yy
    H   hour - 00 to 23
    M   minute - 00 to 59
    S   second - 00 to 61
    T   time as HH:MM:SS
    j   day of year - 001 to 366
    w   day of week - 0 to 6 (Sunday = 0)
    a   abbreviated weekday - Sun to Sat
    h   abbreviated month - Jan to Dec
    r   time in AM/PM notation


    If format is the empty (zero length) string, the date and time format
    (DTFMT) of the currently selected LCTIME locale is used.

    The maximum length of the resultant string is defined by the constant
    NLTEXTMAX in the limits.h file.

 See also

    ctime(S), difftime(S), mktime(S), limits(FP), nlinit(S), stime(S),
    time(S), timtbl(M)

 Standards conformance

    nlcxtime and nlascxtime are not part of any currently supported stan-
    dard; they are extensions of AT&T System V provided by The Santa Cruz
    Operation, Inc.