TimeToString (Function)

ONLINE HELP
FOR WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

Functions for managing dates and times

See also

TimeToString (Function)

In french: HeureVersChaîne

Formats the time passed in a parameter according to the specified format.

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

Versions 15 and later

This function is now available for the Android applications.

New in version 15

This function is now available for the Android applications.

Versions 16 and later

This function is now available for the Windows Phone applications.

New in version 16

This function is now available for the Windows Phone applications.

Versions 17 and later

This function is now available for the iPhone/iPad applications.

New in version 17

This function is now available for the iPhone/iPad applications.

Versions 18 and later

This function is now available in Android Widget mode.

This function is now available in Windows Store apps mode.

New in version 18

This function is now available in Android Widget mode.

This function is now available in Windows Store apps mode.

This function is now available in Android Widget mode.

This function is now available in Windows Store apps 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.

Example

// Format 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"

// Format 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> [, <Format>])

<Result>: Character string

Character string in the specified format.

<Time>: Character string (with quotes) or Time variable

Character string containing the time in HHMMSSCC format (HH corresponds to the hours, MM to the minutes, SS to the seconds and CC to the hundredths of a second).

<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, the characters:
HH represent the number of hours,
MM represent the number of minutes,
SS represent the number of seconds,
CC represent the number of hundredths of a second,
AP represent "AM" or "PM" (if "AM" is found in the format, the time is displayed over 12 hours).
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. 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. 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. This constant is not available.
If this parameter is not specified, the result is in HH:MM:SS:CC format.
This syntax is not available in this version. The result is in HH:MM:SS:CC format.

Remarks

Validity of the time

The validity of the time passed in parameter is checked. A message is displayed if the time is invalid. The validity of a time can be checked by 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.

Component : wd240std.dll