ONLINE HELP
 WINDEVWEBDEV AND WINDEV MOBILE

Help / WLanguage / WLanguage properties / Time and date management properties
  • Managing the minutes and the hours
  • Operators available for the minutes
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 Minute property is used to:
  • Retrieve the minutes from a Time or DateTime variable, or the number of minutes from a Duration variable.
  • Change the minutes in a Time or DateTime variable, or the number of minutes in a Duration variable.
  • Retrieve the minutes or the number of minutes from a Date item (in "Date and Time" or "Duration" format) or from a Time item.
    WEBDEV - Browser codePHP Not available.
  • Modify the minutes or the number of minutes in a Date item (in "Date and Time" or "Duration" format) or in a Time item.
    WEBDEV - Browser codePHP Not available.
Remark: The Minute property is used to easily change times and durations (add one hour, etc).
Reminder: Date items are used to manage:
  • simple dates: "Year - Month - Day" (YYYYMMDD format)
  • dates and times: "Year - Month - Day - Hours - Minutes - Seconds - Milliseconds" (YYYYMMDDHHmmSSCCC format)
  • durations: "Number of days - Number of hours - Number of minutes - Number of seconds - Number of milliseconds" (+DHHMMSSCCC format)
Example
StartTime is Time = "1230"
// Add 50 minutes
StartTime.Minute += 50
// StartTime corresponds to 13:20

// Modify the minutes
StartTime.Minute = 10
Work.StartTime = "1230"
// Add 50 minutes
Work.StartTime.Minute += 50
// StartTime corresponds to 13:20

// Modify the minutes
Work.StartTime.Minute = 10
Syntax

Finding out the number of minutes in a Time, DateTime or Duration variable Hide the details

<Result> = <Time>.Minute
<Result>: Integer
Number of minutes on 2 digits.
<Time>: Time, DateTime or Duration
Name of the variable of type Time, DateTime or Duration to be used.

Modifying the number of minutes in a Time, DateTime or Duration variable Hide the details

<Time>.Minute = <New number of minutes>
<Time>: Time, DateTime or Duration
Name of the variable of type Time, DateTime or Duration to be used.
<New number of minutes>: Character string or integer
New number of minutes (included between 0 and 59). Replaces the number of minutes in the specified variable.
WEBDEV - Browser codePHP Not available in browser code and in PHP

Finding out the number of minutes in a Time or Date item (in "Date and Time" or "Duration" format) Hide the details

<Result> = <Data file>.<Item>.Minute
<Result>: Integer
Number of minutes on 2 digits.
<Data file>: Character string
Name of the data file used. This name was defined in the data model editor or with the File Description type.
<Item>: Character string
Name of the item used. This name is defined in the data model editor or with the Item Description type.
WEBDEV - Browser codePHP Not available in browser code and in PHP

Modifying the number of minutes in a Time or Date item (in "Date and Time" or "Duration" format) Hide the details

<Data file>.<item>.Minute = <New number of minutes>
<Data file>: Character string
Name of the data file used. This name was defined in the data model editor or with the File Description type.
<Item>: Character string
Name of the item used. This name was defined in the data model editor or with the Item Description type.
<New number of minutes>: Character string or integer
New number of minutes (included between 0 and 59). Replaces the number of minutes in the specified item.
Remarks

Managing the minutes and the hours

Case 1: Direct assignment
During a direct assignment (for example, MyTime.Minute = n), the minutes must be included between 00 and 59. A WLanguage error occurs if an invalid number of minutes is specified.
The syntax MyTime.Minute = MyTime.Minute + 5 may generate an error at run time.
Case 2: Operations on the minutes
When performing operations on Time and DateTime, variables, hours go from 0 to 23, and minutes go from 0 to 59. The addition or subtraction of minutes automatically takes into account the changes from 59 minutes to the next hour.
Therefore, if 50 minutes are added to:
  • a variable of type Time corresponding to 23:35, the result will be 0:25.
  • a variable of type DateTime, the hour and the number of minutes will be modified (an hour will be added).
// Example on a variable
StartTime is Time = "2335"   
StartTime.Minute += 50
// StartTime corresponds to 0:25
 
StartTime is DateTime = "202011262335"
StartTime.Minute += 50
// StratTime corresponds to 27/11/2020 at 0:25

Operators available for the minutes

The following arithmetic operators can be used with the Minute property:
  • ++ and --
  • += and -=
// Example on an item
Work.StartTime = "1320"
Work.StartTime.Minute++     // Add 1 minute
Work.StartTime.Minute+=5     // Add 5 minutes
Work.StartTime.Minute-=5 // Subtract 5 minutes
Minimum version required
  • Version 9
This page is also available for…
Comments
Click [Add] to post a comment

Last update: 03/06/2024

Send a report | Local help