# InternationalFileDate

int InternationalFileDate (const char fileName[], char date[], int 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 | integer | 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 | integer | 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.