Second (Property)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

Managing the seconds
Operators available for the seconds

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

Second (Property)

In french: Second

The Second property is used to:

Retrieve the number of seconds from a Time, DateTime or Duration variable.
Modify the number of seconds in a Time, DateTime or Duration variable.
Retrieve the seconds or the number of seconds from a Date item (in "Date and Time" or "Duration" format).
Not available.
Modify the seconds or the number of seconds in a Date item (in "Date and Time" or "Duration" format).
Not available.

Remark: The Second property is used to easily change times and durations.

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

Example

// Operations performed on a DateTime variable
StartTime is DateTime = "200112311230250"
// Add 50 seconds
StartTime.Second += 50// Modify the seconds
StartTime.Second = 50

// Operations performed on a DateTime item
Work.StartTime = "200112311230250"
// Add 50 seconds
Work.StartTime.Second += 50// Modify the seconds
Work.StartTime.Second = 50

Syntax

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

<Result> = <Time>.Second

<Result>: Integer

Number of seconds on 2 digits.

<Time>: DateTime or Duration

Name of the variable of type Time, DateTime or Duration to be used.

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

<Time>.Second = <New number of seconds>

<Time>: DateTime or Duration

Name of the variable of type Time, DateTime or Duration to be used.

<New number of seconds>: Character string or integer

New number of seconds (between 1 and 59).

Not available in browser code or PHP

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

<Result> = <Data file>.<Item>.Second

<Result>: Integer

Number of seconds 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 or PHP

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

<Data file>.<Item>.Second = <New number of seconds>

<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 seconds>: Character string or integer

New number of seconds (between 1 and 59).

Remarks

Managing the seconds

Case 1: Direct assignment
During a direct assignment (for example, MyWork.MyDateTime.Second = n), the seconds must be found between 00 and 59. A WLanguage error occurs if an invalid number of seconds is specified.
The notation MyWork.MyDateTime.Second= MyWork.MyDateTime.Second + 5 may generate a runtime error.
Case 2: Operations on the seconds
When performing operations on the Date items (in 'Date and Time' or 'Duration' format), the seconds are included between 00 and 59. The addition or the subtraction of seconds automatically takes into account the changes from 59 seconds to 1 minute.

Operators available for the seconds

The following arithmetic operators can be used with the Second property:

++ and --
+= and -=

// Example on an item
Work.StartDateTime = "200411261324320"
Work.StartDateTime.Second++ // Add 1 second
Work.StartDateTime.Second+=5 // Add 5 seconds
Work.StartDateTime.Second-=5 // Subtract 5 seconds