Class

• <DRM Relative Time>

Superclass

• <DRM Time Point>

Subclass

• None.

Definition

An instance of this DRM class specifies a date and time relative to either a specified GMT (<DRM Absolute Time>); or if an <DRM Absolute Time> instance is not specified, relative to the simulation start time.

The delta_days field specifies the number of days relative to the specified time.

The delta_hours field specifies the number of hours relative to the specified time, after delta_days has been taken into account.

The delta_minutes field specifies the number of minutes relative to the specified time, after delta_days and delta_hours have been taken into account.

The delta_seconds field specifies the number of seconds relative to the specified time after delta_minutes have been taken into account. Fractions of the delta_seconds field value provide higher accuracy if needed, such as milliseconds.

Class diagram

Figure 6.263 — DRM_Relative_Time

Constraints

• Legal time ranges
• Publishable Object
• Time dependency

Example(s)

• The date / time is a astronomical Julian day of 2449143.77083 (June 5, 1993 0630Z). Astronomical Julian dates are referenced to 1 January 4712 BCE at 12Z. Since the fractional days shall be converted to hours, minutes and seconds, the fields in the <DRM Relative Time> instance are as follows:

  delta_days = 2449143
  delta_hours = 18
  delta_minutes = 30
  delta_seconds = 0,0

  The fields in the <DRM Absolute Time> component are as follows:

  configuration  = DATE_YMD_AND_TIME_H
  value          = {ymd_h = {year         = -4712
                             month        = JANUARY
                             day_of_month = 1
                             hour         = 12 }}

• The time is 6 hours 25 minutes and 30 seconds after the start of the simulation. The fields of the <DRM Relative Time> instance are set as follows:

  delta_days = 0
  delta_hours = 6
  delta_minutes = 25
  delta_seconds = 30,0

• An object becomes active 20 minutes after the simulation starts. That is, its activation time is expressed in simulation time (relative to the start of the simulation), so the activation time would be specified using <DRM Relative Time>. The time_significance field would be set to OCCURRENCE.