TimeToString (Function)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

Functions for managing dates and times

See also

TimeToString (Function)

In french: HeureVersChaîne

Converts a time to a string in the specified format.

In this version, the time passed as parameter is converted according to the "HH:MM:SS:CC" format.

Versions 15 and later

This function is now available for Android applications.

New in version 15

This function is now available for Android applications.

Versions 17 and later

This function is now available for iPhone/iPad applications.

New in version 17

This function is now available for iPhone/iPad applications.

Versions 18 and later

This function is now available in Android Widget mode.

New in version 18

This function is now available in Android Widget mode.

Versions 21 and later

This function is now available in Universal Windows 10 App mode.

New in version 21

This function is now available in Universal Windows 10 App mode.

Versions 26 and later

This function is now available for Apple Watch applications.

New in version 26

This function is now available for Apple Watch applications.

Example

// Convert the specified time according to the "HH:MM:SS:CC" format
TimeToString("12005956") // Returns "12:00:59:56"
Left(TimeToString("12005956"), 5) // Returns "12:00"

// Convert the time specified according to the format: "It is: HH h MM"
TimeToString(Now(), "It is: HH h MM") // Returns "It is: 12 h 32"

TodaysDate is Date = DateSys()
EDT_EditDate = DateToDayInAlpha(TodaysDate) + " " + TodaysDate.Day + ...
" " + DateToMonthInAlpha(TodaysDate) + " at " + ...
TimeToString(TimeSys(), "HH:MM:SS")
// The EDT_EditDate control contains for example: Monday 20 August at 14:44:17

Syntax

<Result> = TimeToString(<Time to convert> [, <Format>])

<Result>: Character string

Character string in the specified format.

<Time to convert>: Character string (with quotes), Time or DateTime variable

Time to use. This time can correspond to:
a character string in HHMMSSCC format (HH corresponds to hours, MM to minutes, SS to seconds and CC to hundredths of a second).
Versions 24 and later
a character string in YYYYMMDDHHmmSSCC format (YYYY corresponds to the year, MM to the month, DD to the day, HH to hours, mm to minutes, SS to seconds and CC to hundredths of a second). In this case, only the time is taken into account.
New in version 24
a character string in YYYYMMDDHHmmSSCC format (YYYY corresponds to the year, MM to the month, DD to the day, HH to hours, mm to minutes, SS to seconds and CC to hundredths of a second). In this case, only the time is taken into account.
a character string in YYYYMMDDHHmmSSCC format (YYYY corresponds to the year, MM to the month, DD to the day, HH to hours, mm to minutes, SS to seconds and CC to hundredths of a second). In this case, only the time is taken into account.
a Time variable.
Versions 24 and later
a DateTime variable. In this case, only the time is taken into account.
New in version 24
a DateTime variable. In this case, only the time is taken into account.
a DateTime variable. In this case, only the time is taken into account.

<Format>: Optional character string (with quotes)

Format that must be applied to the time. This parameter corresponds to:
a character string (a sentence for example). The specific characters representing the different elements of the time (HH, MM, SS, CC or AP) will be automatically replaced by their value identified in the <Time> string. In this string:
HH represents the number of hours,
MM represents the number of minutes,
SS represents the number of seconds,
CC represents the number of hundredths of a second,
AP represents "AM" or "PM" (if "AP" is used, the time is displayed in 12-hour format).
Versions 17 and later
the maskSystemTime constant. This constant allows you to directly use the mask used by the system time.
This constant is not available.
New in version 17
the maskSystemTime constant. This constant allows you to directly use the mask used by the system time.
This constant is not available.
the maskSystemTime constant. This constant allows you to directly use the mask used by the system time.
This constant is not available.
If this parameter is not specified, the result is in HH:MM:SS:CC format.

Remarks

Time validity

The time validity passed as parameter is checked. A message is displayed if the time is invalid. You can check the validity of a time using TimeValid.

Tip: To have a valid time in a string, the time must be entered in a Time Edit control.

Time format

TimeToString is used to format a time returned by IntegerToTime or TimeSys. The result can be assigned to a text control, for example.

Business / UI classification : Neutral code

Component : wd260std.dll