# InternationalTime

int InternationalTime (char time[], int stringBufferSize);

## Purpose

Returns a string representation of the current 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
stringBufferSize | integer | 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 | integer | 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.