InternationalFileTime
int InternationalFileTime (const char fileName[], char time[], size_t stringBufferSize);
Purpose
Returns a string representation of the file time in a format appropriate to internationalization settings of the computer.
 |
Note This function depends on the operating system and C Library support for international time formats. On some systems, the time returned may not be in correct format for the location. |
This function is not safe for use in a multi–threaded program because it temporarily changes the current locale in the ANSI C time library.
Parameters
| Input | ||
| Name | Type | Description |
| fileName | const char[] | Specifies the pathname of the file for which to get the time. |
| stringBufferSize | size_t | Pass the size (including space for the terminating null byte) of the string buffer in which the formatted time is to be stored. |
| Output | ||
| Name | Type | Description |
| time | char [] | Pass a string buffer in which to store the formatted time. |
Return Value
| Name | Type | Description |
| numberOfCharacterFormatted | int | Returns the number of characters in the internationally formatted time string. This function returns zero if the time could not be formatted into the buffer. This function returns a negative User Interface Library error code if the file's time could not be accessed. |
Additional Information
Library: Programmer's Toolbox
Include file: toolbox\toolbox.h
LabWindows/CVI compatibility: LabWindows/CVI 4.0 and later