ONLINE HELP
 WINDEVWEBDEV AND WINDEV MOBILE

Help / WLanguage / WLanguage properties / Time and date management properties
  • Managing the seconds
  • Operators available for the seconds
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 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).
  • Modify the seconds or the number of seconds in a Date item (in "Date and Time" or "Duration" format).
Remark: The Second property is used to easily change times and durations.
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
// 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 is 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

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