TimeToString (Function)

WINDEV, WEBDEV AND WINDEV MOBILE
ONLINE HELP

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 Android applications.

New in version 15

This function is now available for Android applications.

Versions 16 and later

This function is now available for Windows Phone applications.

New in version 16

This function is now available for Windows Phone 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.

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), 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 year, MM to month, DD to day, HH to hour, 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 year, MM to month, DD to day, HH to hour, 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 year, MM to month, DD to day, HH to hour, 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, 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