Click above to get retro games delivered to your door ever month!

Synopsis:
    #include <dos.h>
    unsigned _dos_getftime( int handle,
                            unsigned short *date,
                            unsigned short *time );

Description:
    The _dos_getftime function uses system call 0x57 to get the date and
    time that the file associated with handle was last modified.  The date
    consists of the year, month and day packed into 16 bits as follows:

    bits 0-4
        Day (1-31)

    bits 5-8
        Month (1-12)

    bits 9-15
        Year (0-119 representing 1980-2099)

    The time consists of the hour, minute and seconds/2 packed into 16 bits
    as follows:

    bits 0-4
        Seconds/2 (0-29)

    bits 5-10
        Minutes (0-59)

    bits 11-15
        Hours (0-23)


Returns:
    The _dos_getftime function returns zero if successful.  Otherwise, it
    returns an MS-DOS error code and sets  errno to one of the following
    values:

    EBADF
        Invalid file handle


See Also:
    _dos_setftime

Example:
    #include <stdio.h>
    #include <dos.h>
    #include <fcntl.h>

    #define YEAR(t)   (((t & 0xFE00) >> 9) + 1980)
    #define MONTH(t)  ((t & 0x01E0) >> 5)
    #define DAY(t)    (t & 0x001F)
    #define HOUR(t)   ((t & 0xF800) >> 11)
    #define MINUTE(t) ((t & 0x07E0) >> 5)
    #define SECOND(t) ((t & 0x001F) << 1)

    void main()
      {
        int      handle;
        unsigned short date, time;

        if( _dos_open( "file", O_RDONLY, &handle ) != 0 ) {
          printf( "Unable to open file\n" );
        } else {
          printf( "Open succeeded\n" );
          _dos_getftime( handle, &date, &time );
          printf( "The file was last modified on %d/%d/%d",
                  MONTH(date), DAY(date), YEAR(date) );
          printf( " at %.2d:%.2d:%.2d\n",
                  HOUR(time), MINUTE(time), SECOND(time) );
          _dos_close( handle );
        }
      }

    produces the following:

    Open succeeded
    The file was last modified on 12/29/1989 at 14:32:46

Classification:
    DOS

Systems:
    DOS, Win, OS/2 1.x(all), OS/2 2.x, NT, DOS/PM