Time (Type of variable)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

Declaration and initialization
Assigning a Time variable to a Time item
Properties that can be used on the times
Limits

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

Time (Type of variable)

In french: Heure

The Time type allows you to easily handle the times. This type is used to manage the conversions almost automatically (TimeToString, TimeToInteger, ...)

This type can be used:

to retrieve and handle the HFSQL items in Time format.
to retrieve and handle the edit controls in Time format.
in the WLanguage functions used to manage the times.
to perform calculations on the times (difference, addition, ...). For more details, see Operations that can be performed on the Time type.

Remarks:

Several properties can be used with the Time type, to retrieve part of the time for example (hour, minute, ...).
For more details on the declaration of this type of variable and the use of WLanguage properties, see Declaring a variable.

Versions 16 and later

This type of variable is now available for Windows Phone applications.

New in version 16

This type of variable is now available for Windows Phone applications.

Versions 17 and later

This type of variable is now available for iPhone/iPad applications.

New in version 17

This type of variable is now available for iPhone/iPad applications.

Versions 18 and later

This type of variable is now available in Windows Store apps mode.

This type of variable is now available in Android widget mode.

New in version 18

This type of variable is now available in Windows Store apps mode.

This type of variable is now available in Android widget mode.

This type of variable is now available in Windows Store apps mode.

This type of variable is now available in Android widget mode.

Versions 20 and later

This type of variable is now available in browser code.

New in version 20

This type of variable is now available in browser code.

Versions 21 and later

This type of variable is now available in Universal Windows 10 App mode.

This type of variable is now available in Apple Watch mode.

New in version 21

This type of variable is now available in Universal Windows 10 App mode.

This type of variable is now available in Apple Watch mode.

This type of variable is now available in Universal Windows 10 App mode.

This type of variable is now available in Apple Watch mode.

Example

StartTime is Time = 1205
EndTime is Time = "2030" // 20:30
CurrentTime is Time = TimeSys()

Syntax

Declaring and initializing a variable Hide the details

<Variable name>:

Name of the variable to declare.

<Value>:

Value that will be assigned to the variable. The type of this value can be:
Time
DateTime: only the time will be taken into account.
character string, in the following format:
HHMM
HHMMSS
HHMMSSCC
HHMMSSCCC
Only the hours and the minutes will be taken into account.
(HH: Hour, MM: minutes, SS: seconds, CC: hundredths of a second, CCC: thousandths of a second)
integer: the time will correspond to the number of hundredths of a second passed since midnight "00:00:00:00". Midnight corresponds to the integer 0. It cannot exceed 8, 639, 999 (24 hours - 1 hundredth of a second).

Remarks

Declaration and initialization

A Time variable can be initialized with a value of the following type:
- Time
- DateTime: only the time will be taken into account.
- character string, in the following format:
  - HHMM
  - HHMMSS
  - HHMMSSCC
  - HHMMSSCCC
  Only the hours and the minutes will be taken into account (HH: Hour, MM: minutes, SS: seconds, CC: hundredths of a second, CCC: thousandths of a second).
- integer: the time will correspond to the number of hundredths of a second passed since midnight "00:00:00:00". Midnight corresponds to the integer 0. It cannot exceed 8, 639, 999 (24 hours - 1 hundredth of a second).
By default, a Time variable is initialized with the system time. To define the default value assigned to the Date, Time and DateTime variables, use DateTimeByDefault.

Versions 19 and later
Remark: You also have the ability to initialize a Time variable with the system time by using Now.

New in version 19
Remark: You also have the ability to initialize a Time variable with the system time by using Now.

Remark: You also have the ability to initialize a Time variable with the system time by using Now.

Assigning a Time variable to a Time item

From now on, when a Time variable is assigned to a Time item, the seconds and the hundreds of a second are taken into account according to the format of the item.

For example, if the Time variable corresponds to "HHMMSSCCC":


Item of the data file	Up to version 100050 of WINDEV, WEBDEV, WINDEV Mobile	From version 100050 of WINDEV, WEBDEV and WINDEV Mobile
String item	HHMM	HHMMSSCCC
Time item in HHMM format	HHMM	HHMM
Time item in HHMMSS format	HHMM	HHMMSS
Time item in HHMMSSMM format	HHMM	HHMMSSMM

Properties that can be used on the times

The following properties can be used on the times:


Time	Returns or modifies the hour (in integer format).
Millisecond	Returns or modifies the number of milliseconds (in integer format).
Minute	Returns or modifies the number of minutes (in integer format).
Second	Returns or modifies the number of seconds (in integer format).

For more details, see Operations that can be performed on the Time type.

StartTime is Time = "20011201"
// Adds 5 hours
StartTime.Hour += 5
// Modifies the number of minutes
StartTime.Minute = 5

Limits

The Time type is used to manage the hours found between 00:00 and 23:59. The precision is up to the millisecond.