Minute (Property)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

Managing the minutes and the hours
Operators available for the minutes

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

Minute (Property)

In french: Minute

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.
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.
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:

"Year - Month - Day" dates (YYYYMMDD format)
"Year - Month - Day - Hours - Minutes - Seconds - Milliseconds" dates and times (YYYYMMDDHHmmSSCCC format)
"Number of days - Number of hours - Number of minutes - Number of seconds - Number of milliseconds" durations (+DHHMMSSCCC format)

Versions 17 and later

This property is now available for iPhone/iPad applications.

New in version 17

This property is now available for iPhone/iPad applications.

Versions 20 and later

This property is now available in browser code for the Time, DateTime or Duration variables.

New in version 20

This property is now available in browser code for the Time, DateTime or Duration variables.

Versions 21 and later

This property is now available in Universal Windows 10 App mode.

This property is now available in Apple Watch mode.

New in version 21

This property is now available in Universal Windows 10 App mode.

This property is now available in Apple Watch mode.

This property is now available in Universal Windows 10 App mode.

This property is now available in Apple Watch mode.

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.

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 was defined in the data model editor or with the Item Description type.

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 DateTime variable, 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