StringToDuration (Function)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

Date and time management functions

Date management constants

DateTimeLocalToTimeZone

DateTimeLocalToUTC

DateTimeTimeZoneToLocal

Functions for managing dates and times

IntegerToDate

IntegerToDay

IntegerToDayInAlpha

IntegerToMonthInAlpha

Managing dates and times

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

StringToDuration (Function)

In french: ChaîneVersDurée

Converts a duration in character string format to a duration that can be used by a Duration variable.

Remark: This function is mainly used to assign the result of DateTimeDifference to a Duration variable.

Versions 16 and later

This function is now available for Android applications.

New in version 16

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.

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 20 and later

This function is now available in browser code.

New in version 20

This function is now available in browser code.

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

// To fill a duration from the result of DateTimeDifference
sDiff is string
sDiff = DateTimeDifference(sStart, sEnd)
// Convert the difference to a Duration variable
dDuration is Duration
dDuration = StringToDuration(sDiff, durationCenti)

sMyString is string = "The duration is 3 days, 13 hours, 45 minutes."
dDuration is Duration
dDuration = StringToDuration(sMyString, "The duration is D days, HH hours, MM minutes.")
Trace(dDuration)

Syntax

<Result> = StringToDuration(<String> , <Format>)

<Result>: Duration variable

Duration in a format recognized by the Duration variables.

<String>: Character string

Duration in the format specified in <Format>.

<Format>: Character string

Format of the duration to convert. This format corresponds to:
a character string (a sentence for example). The characters that represent the different elements of the duration (D, HH, MM, SS or CCC) will be automatically replaced by the value in the <String> parameter. In this string:
D represents the number of days,
HH represents the number of hours,
MM represents the number of minutes,
SS represents the number of seconds,
CCC represents the number of milliseconds.
one of the following constants:
durationMilli Format used: "+DHHMMSSCCC"
durationCenti Format used: "+DHHMMSSCC": used to create a duration from the format of the result of DateTimeDifference

Remarks

The direct assignment <Duration variable> = <String> is equivalent to using StringToDuration with the "+DHHMMSSCCC" format.

Business / UI classification: Neutral code

Component: wd260std.dll