DOCUMENT:Q188977 30-JUL-1999 [foxpro] TITLE :HOWTO: Use the Win32 API to Access File Dates and Times PRODUCT :Microsoft FoxPro PROD/VER:WINDOWS:3.0,3.0b,5.0,5.0a OPER/SYS: KEYWORDS: ====================================================================== ------------------------------------------------------------------------------- The information in this article applies to: - Microsoft Visual FoxPro for Windows, versions 3.0, 3.0b, 5.0, 5.0a ------------------------------------------------------------------------------- SUMMARY ======= Visual FoxPro's FDATE() and FTIME() functions can be used to determine the date and time that a file was last written. However, the Win32 file system also stores the creation date and time in addition to the last access date and time. To find these dates and times, it is necessary to use the Win32 functions GetFileTime(), FileTimeToLocalFileTime() and FileTimeToSystemTime(). GetFileTime accepts a handle to an open file, and returns FILETIME structures for the creation time, last access time and last write time. The FILETIME structure is somewhat difficult to work with, because it contains two 32-bit values representing the number of 100 nanosecond intervals since January 1, 1601. Therefore, we want to convert it to a SYSTEMTIME structure. However, Win32 represents all times internally as Greenwich times, so you first apply a local timezone correction by calling FileTimeToLocalFileTime(). Files written by or used by 16-bit Windows or DOS applications may not store all these date and time values. The FoxPro function GetFTime() illustrates the use of these calls. MORE INFORMATION ================ 1. Create and save the following program: ********************************************************* * Function getftime * * Return the create date and time, last access date and time, * last write date and time from a passed filename. * * Passed: * lcFileName (by value): fully-qualified filename * * Returns: * Logical .t. if completed successfully, .f. if not. * * Return variables: * ldCreateDate (date, by reference): Creation date * lcCreateTime (character, by reference): Creation time * (HH:MM:SS.mm) * ldAccessDate (date, by reference): Last access date * lcAccessTime (character, by reference): Last access time * (HH:MM:SS.mm) * lcLastWriteDate (date, by reference): Last write date * lcLastWriteTime (character, by reference): Last write time * (HH:MM:SS.mm) * * * Usage example: (assumes C:\Test.txt exists) m.createdate = {} m.createtime = "" m.accessdate = {} m.accesstime = "" m.lastwritedate = {} m.lastwritetime = "" m.OK = getftime("C:\Test.txt", @m.createdate, @m.createtime, ; @m.accessdate, @m.accesstime, @m.lastwritedate, ; @m.lastwritetime) IF m.OK ? "Create date: ", m.createdate ? "Create time: " , m.createtime ? "Last access date: ", m.accessdate ? "Last access time: ", m.accesstime ? "Last write date: ", m.lastwritedate ? "Last write time: ", m.lastwritetime ELSE ? "Error getting file times" ENDIF * * End of usage example. FUNCTION getftime PARAMETERS lcFileName, ldCreateDate, lcCreateTime, ldAccessDate,; lcAccessTime, ldLastWriteDate, lcLastWriteTime * Blank filename or nonexistent file, no need to continue. IF EMPTY(lcFileName) OR NOT FILE(lcFileName) RETURN .F. ENDIF * DEFINEs for file share mode. #DEFINE FILE_SHARE_READ 1 #DEFINE FILE_SHARE_WRITE 2 * DEFINEs for access right #DEFINE GENERIC_READ hex2dec("80000000") #DEFINE GENERIC_WRITE hex2dec("40000000") * DEFINES for Create Mode. #DEFINE CREATE_NEW 1 #DEFINE CREATE_ALWAYS 2 #DEFINE OPEN_EXISTING 3 #DEFINE OPEN_ALWAYS 4 #DEFINE TRUNCATE_EXISTING 5 * File flag. #DEFINE FILE_ATTRIBUTE_NORMAL hex2dec("80") DECLARE INTEGER CreateFile IN kernel32 ; STRING lpFileName, ; INTEGER dwDesiredAccess, ; INTEGER dwShareMode, ; INTEGER lpSecurityAttributes, ; INTEGER dwCreationDisposition, ; INTEGER dwFlagsAndAttributes, ; INTEGER hTemplateFile DECLARE INTEGER GetFileTime IN kernel32 ; INTEGER hFile, ; STRING @lpCreationTime, ; STRING @lpLastAccessTime, ; STRING @lpLastWriteTime DECLARE INTEGER FileTimeToLocalFileTime IN kernel32 ; STRING @lpFileTime, ; STRING @lpLocalFileTime DECLARE INTEGER FileTimeToSystemTime IN kernel32 ; STRING @lpFileTime, ; STRING @lpSystemTime DECLARE INTEGER GetLastError IN kernel32 DECLARE INTEGER CloseHandle IN kernel32 ; INTEGER hObject * 2 DWORDs * 4 bytes each = an 8-byte buffer. CreationTime = SPACE(8) LastAccessTime = SPACE(8) lastwritetime = SPACE(8) * Same buffers for local time. LocalCreationTime = SPACE(8) LocalLastAccessTime = SPACE(8) LocalLastWriteTime = SPACE(8) * 16-byte buffers for when we convert from the FILETIME * structs to the more human-readable SYSTEMTIME structures. ctSystemTime = SPACE(16) laSystemTime = SPACE(16) lwSystemTime = SPACE(16) * Open an existing file. lhFileHandle = CreateFile(lcFileName, GENERIC_READ, ; FILE_SHARE_READ, 0, OPEN_EXISTING, FILE_ATTRIBUTE_NORMAL, 0) IF lhFileHandle <= 0 =MESSAGEBOX ("Error in CreateFile: Error code - " + ; LTRIM(STR(GetLastError()))) RETURN .F. ENDIF * Make the GetFileTime call, to get Create, Access and Update times. m.retval = GetFileTime(lhFileHandle, CreationTime, ; @LastAccessTime, @lastwritetime) IF m.retval = 0 =MESSAGEBOX("Error calling GetFileTime. Error code: " + ; LTRIM(STR(GetLastError()))) RETURN .F. ENDIF * Successfully performed the GetFileTime call - * now convert each of the three times to local time. * If any of them fail, then exit. IF FileTimeToLocalFileTime(@CreationTime, @LocalCreationTime)=0 OR ; FileTimeToLocalFileTime(@LastAccessTime,@LocalLastAccessTime)=0 OR ; FileTimeToLocalFileTime(@lastwritetime, @LocalLastWriteTime)=0 =MESSAGEBOX("FileTimeToLocalFileTime Failed. Error code: " + ; LTRIM(STR(GetLastError()))) RETURN .F. ENDIF * Now you have a local filetime, convert each to a systemtime that * you can work with. * If any of the calls fail, then exit. IF FileTimeToSystemTime(@LocalCreationTime, @ctSystemTime) = 0 OR ; FileTimeToSystemTime(@LocalLastAccessTime, @laSystemTime) = 0 OR ; FileTimeToSystemTime(@LocalLastWriteTime, @lwSystemTime) = 0 =MESSAGEBOX("FileTimeToSystemTime call failed. Error code: " ; + LTRIM(STR(GetLastError()))) RETURN .F. ENDIF * Unpack the integers in creation time SystemTime structure. ctstYear = Str2Word(LEFT(ctSystemTime, 2)) ctstMonth = Str2Word(SUBSTR(ctSystemTime, 3, 2)) ctstDayofWeek = Str2Word(SUBSTR(ctSystemTime, 5, 2)) ctstDay = Str2Word(SUBSTR(ctSystemTime, 7, 2)) ctstHour = Str2Word(SUBSTR(ctSystemTime, 9, 2)) ctstMinute = Str2Word(SUBSTR(ctSystemTime, 11, 2)) ctstSecond = Str2Word(SUBSTR(ctSystemTime, 13, 2)) ctstMilliSecond = Str2Word(SUBSTR(ctSystemTime, 15, 2)) * Unpack the integers in last access time SystemTime structure. lastYear = Str2Word(LEFT(laSystemTime, 2)) lastMonth = Str2Word(SUBSTR(laSystemTime, 3, 2)) lastDayofWeek = Str2Word(SUBSTR(laSystemTime, 5, 2)) lastDay = Str2Word(SUBSTR(laSystemTime, 7, 2)) lastHour = Str2Word(SUBSTR(laSystemTime, 9, 2)) lastMinute = Str2Word(SUBSTR(laSystemTime, 11, 2)) lastSecond = Str2Word(SUBSTR(laSystemTime, 13, 2)) lastMilliSecond = Str2Word(SUBSTR(laSystemTime, 15, 2)) * Unpack the integers in last write time SystemTime structure. lwstYear = Str2Word(LEFT(lwSystemTime, 2)) lwstMonth = Str2Word(SUBSTR(lwSystemTime, 3, 2)) lwstDayofWeek = Str2Word(SUBSTR(lwSystemTime, 5, 2)) lwstDay = Str2Word(SUBSTR(lwSystemTime, 7, 2)) lwstHour = Str2Word(SUBSTR(lwSystemTime, 9, 2)) lwstMinute = Str2Word(SUBSTR(lwSystemTime, 11, 2)) lwstSecond = Str2Word(SUBSTR(lwSystemTime, 13, 2)) lwstMilliSecond = Str2Word(SUBSTR(lwSystemTime, 15, 2)) * Close the file handle. llRetCode = CloseHandle(lhFileHandle) * Format the return variables. ldCreateDate = CTOD(LTRIM(STR(ctstMonth)) + "/" + ; LTRIM(STR(ctstDay))+ ; "/" + LTRIM(STR(ctstYear))) lcCreateTime = PADL(LTRIM(STR(ctstHour)), 2, "0") + ":" + ; PADL(LTRIM(STR(ctstMinute)), 2, "0") + ":" + ; PADL(LTRIM(STR(ctstSecond)), 2, "0") + "." + ; PADL(LTRIM(STR(ctstMilliSecond)), 3, "0") ldAccessDate = CTOD(LTRIM(STR(lastMonth)) + "/" + ; LTRIM(STR(lastDay))+ ; "/" + LTRIM(STR(lastYear))) lcAccessTime = PADL(LTRIM(STR(lastHour)), 2, "0") + ":" + ; PADL(LTRIM(STR(lastMinute)), 2, "0") + ":" + ; PADL(LTRIM(STR(lastSecond)), 2, "0") + "." + ; PADL(LTRIM(STR(lastMilliSecond)), 3, "0") ldLastWriteDate = CTOD(LTRIM(STR(lwstMonth))+ ; "/"+LTRIM(STR(lwstDay))+ ; "/" + LTRIM(STR(lwstYear))) lcLastWriteTime = PADL(LTRIM(STR(lwstHour)), 2, "0") + ":" + ; PADL(LTRIM(STR(lwstMinute)), 2, "0") + ":" + ; PADL(LTRIM(STR(lwstSecond)), 2, "0") + "." + ; PADL(LTRIM(STR(lwstMilliSecond)), 3, "0") * Function hex2dec - Convert a character hex value into decimal. * Handy for dealing with Hex declarations in API calls. * Passed: m.hex (character hex value) * Returns: Decimal value FUNCTION hex2dec PARAMETER m.hex m.decimal = 0 FOR i = LEN(m.hex) TO 1 STEP -1 m.decimal = m.decimal + (AT(SUBSTR(m.hex, i, 1), ; "0123456789ABCDEF") - 1) * 16 ^ (i - 1) NEXT RETURN m.decimal * Function str2word - Converts low-high format string representation * to a 16-bit integer (word) value. Useful for unrolling structure * members containg WORD types. * * Passed: Low-high string representation of 16-bit integer * Returns: numeric value FUNCTION Str2Word PARAMETERS m.wordstr PRIVATE i, m.retval m.retval = 0 FOR i = 0 TO 8 STEP 8 m.retval = m.retval + (ASC(m.wordstr) * (2^i)) m.wordstr = RIGHT(m.wordstr, LEN(m.wordstr) - 1) NEXT RETURN m.retval 2. Create a file named Test.txt in the C:\ root for testing purposes. 3. Run the program. It should display the creation, last access and last write dates and times on the Visual FoxPro desktop. REFERENCES ========== Win32 API Help; (included with the Platform SDK) topics: "GetFileTime", "FileTimeToLocalTime", "FileTimeToSystemTime", "SYSTEMTIME" and "FILETIME" Additional query words: GetFileTime FileTimeToLocalFileTime FileTimeToSystemTime FILETIME SYSTEMTIME time update kbnokeyword ====================================================================== Keywords : Technology : kbVFPsearch kbAudDeveloper kbVFP300 kbVFP300b kbVFP500 kbVFP500a Version : WINDOWS:3.0,3.0b,5.0,5.0a Issue type : kbhowto ============================================================================= THE INFORMATION PROVIDED IN THE MICROSOFT KNOWLEDGE BASE IS PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND. MICROSOFT DISCLAIMS ALL WARRANTIES, EITHER EXPRESS OR IMPLIED, INCLUDING THE WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. IN NO EVENT SHALL MICROSOFT CORPORATION OR ITS SUPPLIERS BE LIABLE FOR ANY DAMAGES WHATSOEVER INCLUDING DIRECT, INDIRECT, INCIDENTAL, CONSEQUENTIAL, LOSS OF BUSINESS PROFITS OR SPECIAL DAMAGES, EVEN IF MICROSOFT CORPORATION OR ITS SUPPLIERS HAVE BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES. SOME STATES DO NOT ALLOW THE EXCLUSION OR LIMITATION OF LIABILITY FOR CONSEQUENTIAL OR INCIDENTAL DAMAGES SO THE FOREGOING LIMITATION MAY NOT APPLY. Copyright Microsoft Corporation 1999.