Please ensure Javascript is enabled for purposes of website accessibility
Powered by Zoomin Software. For more details please contactZoomin

AF SDK Reference

AFVersion.SetEffectiveDate Method

  • Last UpdatedNov 18, 2025
  • 3 minute read
AFVersion.SetEffectiveDate Method
Set the effective date for this version of the owning object.

Namespace:  OSIsoft.AF.Asset
Assembly:  OSIsoft.AFSDK (in OSIsoft.AFSDK.dll) Version: 3.1.1.1182

Syntax

public void SetEffectiveDate(
	Object effectiveDate
)
Public Sub SetEffectiveDate ( 
	effectiveDate As Object
)

Dim instance As AFVersion
Dim effectiveDate As Object

instance.SetEffectiveDate(effectiveDate)
public:
void SetEffectiveDate(
	Object^ effectiveDate
)
member SetEffectiveDate : 
        effectiveDate : Object -> unit 

Parameters

effectiveDate
Type: SystemObject
The new effective date for the object. The effectiveDate cannot be equal to or after the ObsoleteDate. The value may be an AFTime, DateTime, PITime, String, or numeric. A DateTime (or a DATE will be treated as UTC time if its Kind property is set to Unspecified. Because DATE values from COM or VB6 clients are marshalled as Unspecified, these client applications must convert to UTC prior to marshalling. An integer numeric represents the number of ticks (100-nanosecond intervals) since January 1, 0001. A floating point numeric represents the number of seconds since January 1, 1970 UTC. A String is interpreted as local time, unless it contains a time zone indicator such as a trailing "Z" or "GMT". Strings will be interpreted with the AFTime.Parse Overload methods so that relative formats with intervals ("*", "T+3h", etc.) are also supported. Relative time intervals are based on AFTime.Now.

Exceptions

ExceptionCondition
ArgumentOutOfRangeException This exception is thrown when the new effectiveDate is greater than or equal to the current ObsoleteDate.

Remarks

This method is used to modify the EffectiveDate for this version of the owning object. Changing the EffectiveDate has the same effect as using the Create(Object, String) method to create a new version at the new effective date and then using the Delete method to remove the old version. Any changes for the current version of the object will be saved to the server after the effective date is changed.

Use the PISystem.Supports method to check if the PISystem supports the Versioning feature.

Caution note Caution
Changing the EffectiveDate may cause the current object to become invalid because it no longer exists at the current query date.

Version Information

AFSDK


See Also

In This Topic
Related Links
TitleResults for “How to create a CRG?”Also Available in