InternationalFileDate
int InternationalFileDate (const char fileName[], char date[], size_t stringBufferSize);
Purpose
Returns a string representation of the file date in a format appropriate to internationalization settings of the computer.
 |
Note This function depends on the operating system and C Library support for international date formats. On some systems, the date 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 date. |
| stringBufferSize | size_t | Pass the size (including space for the terminating null byte) of the string buffer in which the formatted date is to be stored. |
| Output | ||
| Name | Type | Description |
| date | char [] | Pass a string buffer in which to store the formatted date. |
Return Value
| Name | Type | Description |
| numberOfCharacterFormatted | int | Returns the number of characters in the internationally formatted date string. This function returns zero if the date could not be formatted into the buffer. This function returns a negative User Interface Library error code if the file's date could not be accessed. |
Additional Information
Library: Programmer's Toolbox
Include file: toolbox\toolbox.h
LabWindows/CVI compatibility: LabWindows/CVI 4.0 and later