Topic: DMD0037

DTOFFSET - Add Offset to Date/Time

The Add Offset to Date/Time (DTOFFSET) instruction adds a specified amount of time to the contents of a Date/Time structure.

 

Note: use the Copy Memory Range (MEMCOPY) instruction to copy from one Data/Time structure to another.

 

Parameters:

Note: Use the F9 key (Element Browser) or Down-Arrow key (Auto-Complete) at any time to see a complete list of the memory locations that are valid in the current field of the instruction.

 

Starting Date/Time - designates the Date/Time structure that contains the beginning Date and Time. This can be any of the system-defined Date/Time structure, or any user-defined Date/Time structure.

 

Offset - designates the amount of time to add to the Starting Date/Time
 

  • Constant - the amount of time to add is a fixed amount of time specified in number of days / hours / minutes / and seconds. The editor will normalize this value, for example, if a value of 99 seconds is entered the value will be stored as 1 minute and 39 seconds.
     

  • Negative - if checked the Constant value for the Offset is deemed negative, this option allows for pre-dating
     

  • Variable - designates a location where the amount of time (in seconds) to add is stored. This can be any readable numeric location.

 

Ending Date/Time - designates a Date/Time structure to store the result. This can be any of the system-defined User Date/Time structures, or any user-defined Date/Time structure.

 

Status Display:

The status display shows the Offset value fully-qualified values for Date/Time both structures.

 

See Also:

 

Related Topics:

 

Rung Example: