ONLINE HELP
 WINDEVWEBDEV AND WINDEV MOBILE

Help / WLanguage / WLanguage syntax / 
  • Declaration and initialization
  • Assigning a Time variable to a Time item
  • Properties that can be used on the times
  • Limitations
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaReports and QueriesUser code (UMC)
WEBDEV
WindowsLinuxPHPWEBDEV - Browser code
WINDEV Mobile
AndroidAndroid Widget iPhone/iPadIOS WidgetApple WatchMac CatalystUniversal Windows 10 App
Others
Stored procedures
The Time type allows you to easily manipulate times. This type is used to manage conversions almost automatically (TimeToString, TimeToInteger, etc.).
This type can be used:
  • to get and manipulate HFSQL items in Time format.
  • to get and manipulate Time Edit controls.
  • in WLanguage functions to manage times.
  • to perform time calculations (difference, addition, etc.). For more details, see Operations that can be performed on the Time type.
The Time type supports null values. For more details, see Allowing nullable types.

Remarks:
  • Several properties can be used with the Time type to retrieve only a part of the time (hour, minute, etc.).
  • For more details on the declaration of this type of variable and the use of WLanguage properties, see Declaring a variable.
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> 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 fileUp to version 100050 of WINDEV, WEBDEV, WINDEV MobileFrom version 100050 of WINDEV, WEBDEV and WINDEV Mobile
String itemHHMMHHMMSSCCC
Time item in HHMM formatHHMMHHMM
Time item in HHMMSS formatHHMMHHMMSS
Time item in HHMMSSMM formatHHMMHHMMSSMM

Properties that can be used on the times

The following properties can be used on the times:
TimeReturns or modifies the hour (in integer format).
MillisecondReturns or modifies the number of milliseconds (in integer format).
MinuteReturns or modifies the number of minutes (in integer format).
SecondReturns 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

Limitations

The Time type is used to manage the hours found between 00:00 and 23:59. The precision is up to the millisecond.
Minimum version required
  • Version 9
This page is also available for…
Comments
Click [Add] to post a comment

Last update: 03/26/2024

Send a report | Local help