Time Types

The time module defines data types for representing time and dates in the Arda system. These types complement the bitemporal concepts described in Journaled Entities and the time-related primitives in Value Types.

TimeCoordinates

A TimeCoordinates value captures both dimensions of bitemporal time for a change in the system:

Property	Type	Multiplicity	Description
effective	Timestamp	[1..1]	When the change happens in the real world (business effective time)
recorded	Timestamp	[1..1]	When the change is recorded by the system (technical recorded time)

TimeCoordinates is used as the time metadata for every entity record in the system. See Journaled Entities for the full explanation of why both dimensions are needed.

Duration

A Duration represents a length of time, expressed as a decimal number of time units.

Property	Type	Multiplicity	Description
length	Double	[0..1]	The numeric length of the duration
unit	TimeUnit	[0..1]	The unit of measurement for the length

TimeUnit Enumeration

The standard time units supported by the Duration type:

Value	Description
MILLISECOND	One millisecond
SECOND	One second
MINUTE	One minute
HOUR	One hour
DAY	One day
WEEK	One week
STANDARD_MONTH	A standardized month (30 days)
STANDARD_YEAR	A standardized year (365 days)

Timestamp (Primitive Type)

A Timestamp is the number of milliseconds since the Unix epoch (January 1, 1970, 00:00:00.000 UTC). It must be represented in a way that avoids 32-bit integer overflow (i.e., as a 64-bit integer).