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