2.1.8.1 asctime

1 Description
2 Syntax
3 Parameters
4 Return
5 Examples
6 Remark
7 See Also
8 Header to Include
9 Reference

Description

Converts a tm time structure to a character string.

Syntax

char * asctime( TM * timeptr )

Parameters

[input] timeptr, a pointer to TM structure

Return

a pointer to the character string result

Examples

EX1

void asctime_ex1()
{
    struct tm *newtime;
    time_t aclock;
    time( &aclock );                 // Get time in seconds 

    newtime = localtime( &aclock );  // Convert time to struct 
                                    // tm form 
    // Print local time as a string 
    printf( "The current date and time are: %s", asctime( newtime ) );
}

Remark

The timeptr value is usually obtained from a call to localtime, which returns a pointer to a tm structure, defined in time.h. It can be seen more at See Also.