DateTime

Application programs can use the TIBCO FTL data type DateTime to represent date and time values with large range and nanosecond precision.

DateTime values combine two numeric components:

  • The sec component represents whole seconds with up to 64 bits. Zero denotes the UNIX epoch: midnight entering January 1, 1970.
  • The nsec component represents nanoseconds after the time that the sec component denotes. Although the data structure stores this component in a signed 64-bit integer, this component is always non-negative, between zero and 999,999,999 (inclusive).

For example, the value -1 seconds plus 999,999,998 nanoseconds represents December 31, 1969, 2 nanoseconds before midnight (that is, 2 nanoseconds before the epoch).

Related concepts
Related reference