- Declaration and initialization
- Assigning a Time variable to a Time item
- Properties that can be used on the times
- Limits
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.
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> is Time = <Value>
OR
<Variable name> is Time
<Variable name> = <Value>
<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.
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
The Time type is used to manage the hours found between 00:00 and 23:59. The precision is up to the millisecond.
This page is also available for…
|
|
|
|