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

..Second 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).
Modify the seconds or the number of seconds in a Date item (in "Date and Time" or "Duration" format).

Remark: ..Second is used to simplify the operations performed on the times and durations.

Reminder: The Date items are used to manage:

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

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 Time, DateTime or Duration variable to use.

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 Time, DateTime or Duration variable to use.

<New number of seconds>: Character string or integer

New number of seconds (between 1 and 59).

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 (with or without quotes)

Name of data file used. This name was defined in the data model editor or by the File description type.

<Item>: Character string (with or without quotes)

Name of item used. This name was defined in the data model editor or by the Item description type.

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 (with or without quotes)

Name of data file used. This name was defined in the data model editor or by the File description type.

<Item>: Character string (with or without quotes)

Name of item used. This name was defined in the data model editor or by 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 by ..Second:

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