DEENESPTFRRUARHIKOZHNL

struct ara::tsync::TimeBase

[SWS_TS_01260] Upstream: RS_AP_00130, RS_TS_00005 wording not yet imported

struct TimeBase {...};

The class TimeBase is a pseudo-clock. The class TimeBase is a pseudo-clock that is used as the first template argument to std::chrono::time_point to indicate that the time point represents local time with respect of a not-yet-specified timeBaseResource.

Header-Datei#include "ara/tsync/timestamp.h"
Forwarding-Header#include "ara/tsync/tsync_fwd.h"
Scopenamespace ara::tsync

User GuideAI-GENERATED

Serves as a pseudo-clock for std::chrono::time_point to map local points in time of a time base resource.
AI-GENERATED unreviewed Model: gemini-3.8-flash-medium · Effort: medium · Temperature: not controllable · Prompt: f515350f98f7 Provenance Open questions (3)
translated from the German guidegemini-3.8-flash-low · 2026-10-13 · German original

Serves as a pseudo-clock for std::chrono::time_point to map local points in time of a time base resource.

The class ara::tsync::TimeBase acts as a pseudo-clock in the C++ standard library system and serves as a clock template argument for std::chrono::time_point to represent local times with respect to a time base resource [SWS_TS_01264]. To fulfill the clock requirements, it provides standardized type aliases for nanosecond resolution and duration. As a key constraint, the clock is specified via is_steady = false as non-steady, which accounts for time jumps resulting from synchronization operations [SWS_TS_01265].

Context

The class or struct ara::tsync::TimeBase assumes the role of a pseudo-clock in the tsync module of the AUTOSAR Adaptive Platform. At C++ level, it primarily serves as the first template argument for std::chrono::time_point in order to semantically specify that a timestamp represents the local time relative to a not yet closer specified time base resource (timeBaseResource) [SWS_TS_01264]. Instead of acting as an active time source with a static time query itself, TimeBase functions as a formal link within the standard library std::chrono.

By providing the standardized type definitions, TimeBase binds the generic mechanisms of C++ time measurement to the synchronization module. Consumers and components that work with points in time or time spans use the structure's alias types to exchange typed timestamps. In this way, it is guaranteed that time values via std::chrono::time_point are unambiguously assigned to a local time base and are not mistakenly mixed with absolute system clocks or differing time sources.

TimeBaseKontext time_point std::chrono::time_point<TimeBase> TimeBase ara::tsync::TimeBase (Pseudo-Clock) TimeBase->time_point dient als Typ-Argument timeBaseResource timeBaseResource (lokale Zeitbasis) timeBaseResource->TimeBase Referenz fuer lokale Zeit Anwendung Anwendungssoftware Anwendung->time_point uses

Context diagram: Embedding of TimeBase as a pseudo-clock into the C++ Chrono type system for binding points in time to a time base resource. Sources: [SWS_TS_01263], [SWS_TS_01264]

Lifecycle

As a pure data and type structure (declared as struct TimeBase in header ara/tsync/timestamp.h), ara::tsync::TimeBase has no dynamic lifecycle phases in the sense of an initialized or operated runtime component. Instantiation of objects of this structure is not strictly necessary for the intended function; it exists primarily at the level of the C++ type system at compile time.

To fulfill the formal C++ clock requirements, TimeBase defines all required type aliases and constants. This includes the fundamental counter type rep as std::int64_t to represent the number of time ticks [SWS_TS_01261] as well as the time tick interval period as std::nano [SWS_TS_01262], which corresponds to a resolution in the nanosecond range. The duration for measuring time since an epoch is provided via the type alias duration as std::chrono::duration<rep, period> [SWS_TS_01263].

With regard to concurrency and behavior in the running system, the structure declares the static constant is_steady with the boolean value false [SWS_TS_01265]. This signals to the C++ Chrono framework that the underlying clock is not steady (monotonic). Interpretation: This is likely attributable to the fact that time synchronization operations in module tsync can cause adjustments or jumps in the local time base, which is why consecutive measurements do not guarantee strict monotonicity. Question Q-93a56c0eb2d35c7b (open) Since the structure itself encapsulates no mutable state, all type usages and accesses to constants are inherently concurrency-safe.

Usage Path

The typical usage path of ara::tsync::TimeBase lies in declaring, processing, and passing time values within synchronized applications. Developers and adaptive software components do not instantiate the clock itself, but access the central type alias time_point, which is defined as std::chrono::time_point<TimeBase> [SWS_TS_01264].

  • Type definition and interface specification: The application includes the header ara/tsync/timestamp.h and uses ara::tsync::TimeBase::time_point [SWS_TS_01264] to declare signatures for timestamps. Interpretation: This ensures that points in time remain semantically coupled to the specific local time base. Question Q-549e2d377c0a6845 (open)
  • Arithmetic and difference calculation: If two points in time are subtracted from each other, the expression automatically yields the type ara::tsync::TimeBase::duration [SWS_TS_01263]. This is based on nanosecond steps (period) [SWS_TS_01262] and 64-bit integers (rep) [SWS_TS_01261], enabling standard-compliant duration calculations and conversions into other time units.
  • Interoperability with standard algorithms: Due to full fulfillment of the clock type requirements, points in time and time spans can be seamlessly passed to standard library functions of std::chrono without having to use proprietary time structures.

Interpretation: Since TimeBase is designed as a pseudo-clock, it does not provide a static member function now() itself; the concrete time value determination for such a time_point [SWS_TS_01264] is likely performed by other services or interfaces of module tsync that are connected to the referenced timeBaseResource. Question Q-2a528a99023dad41 (open)

This guide is based on the AUTOSAR Adaptive Platform R25-11 specification.

Member map

Class diagram

Hohle Dreieckspfeile = Vererbung (zeigt zur Basisklasse); Klicken öffnet die jeweilige Klassenseite.

G nara__tsync__TimeBase940 «struct» TimeBase + is_steady

Detail view

Select an entry in the outline.

Type aliases

duration type alias

required type declaration to fulfill the C++ Clock requirements used to measure the time since epoch

using duration = std::chrono::duration<rep, period>;
period type alias

required type declaration to fulfill the C++ Clock requirements representing the tick period of the duration

using period = std::nano;
rep type alias

required type declaration to fulfill the C++ Clock requirements representing the number of ticks

using rep = std::int64_t;
time_point type alias

represents a point in time

using time_point = std::chrono::time_point<TimeBase>;

Constants

is_steady variable

required constant to fulfill the C++ Clock requirements as steady clock

static constexpr bool is_steady = false;

Type alias documentation

type alias duration [SWS_TS_01263] Upstream: RS_AP_00130, RS_TS_00005 wording not yet imported

using duration = std::chrono::duration<rep, period>;

required type declaration to fulfill the C++ Clock requirements used to measure the time since epoch

Header-Datei#include "ara/tsync/timestamp.h"
Scopestruct ara::tsync::TimeBase
Symbolduration

Request a governed re-review of this record. The record is not changed immediately.

Record
AUTOSAR/AP/record/SWS_TS_01263
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_TS_01263@rel:R25-11#77b32a12
Content hash
77b32a12
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_TimeSynchronization.pdf#nameddest=SWS_TS_01263
Status: valid/unmigrated Version: rel:R25-11#5cf6241f Versionshistorie & Revisions (1 transition, 6 revision)
Current State
valid/unmigrated
Reason
mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record
Campaign
2026-08-13-status-backfill
Active Version
AUTOSAR/AP/record/SWS_TS_01263@rel:R25-11#5cf6241f
Point-in-Time History:
Recorded Revisions (6):
  • R25-11rel:R25-11#77b32a122026-09-30
  • R21-11rel:R21-11#aef3c9f02026-10-14
  • R22-11rel:R22-11#279628e32026-10-14
  • R23-11rel:R23-11#7904d5812026-10-14
  • R24-11rel:R24-11#5cf6241f2026-10-14
  • R25-11rel:R25-11#5cf6241f2026-10-14 active
DateActorTransitionReason / RationaleCampaign
2026-08-13toolnone → valid/unmigratedmechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record2026-08-13-status-backfill

type alias period [SWS_TS_01262] Upstream: RS_AP_00130, RS_TS_00005 wording not yet imported

using period = std::nano;

required type declaration to fulfill the C++ Clock requirements representing the tick period of the duration

Header-Datei#include "ara/tsync/timestamp.h"
Scopestruct ara::tsync::TimeBase
Symbolperiod

Request a governed re-review of this record. The record is not changed immediately.

Record
AUTOSAR/AP/record/SWS_TS_01262
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_TS_01262@rel:R25-11#80c2628e
Content hash
80c2628e
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_TimeSynchronization.pdf#nameddest=SWS_TS_01262
Status: valid/unmigrated Version: rel:R25-11#d2f30081 Versionshistorie & Revisions (1 transition, 6 revision)
Current State
valid/unmigrated
Reason
mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record
Campaign
2026-08-13-status-backfill
Active Version
AUTOSAR/AP/record/SWS_TS_01262@rel:R25-11#d2f30081
Point-in-Time History:
Recorded Revisions (6):
  • R25-11rel:R25-11#80c2628e2026-09-30
  • R21-11rel:R21-11#f7e53bcc2026-10-14
  • R22-11rel:R22-11#4294ebea2026-10-14
  • R23-11rel:R23-11#b0d1dd9c2026-10-14
  • R24-11rel:R24-11#d2f300812026-10-14
  • R25-11rel:R25-11#d2f300812026-10-14 active
DateActorTransitionReason / RationaleCampaign
2026-08-13toolnone → valid/unmigratedmechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record2026-08-13-status-backfill

type alias rep [SWS_TS_01261] Upstream: RS_AP_00130, RS_TS_00005 wording not yet imported

using rep = std::int64_t;

required type declaration to fulfill the C++ Clock requirements representing the number of ticks

Header-Datei#include "ara/tsync/timestamp.h"
Scopestruct ara::tsync::TimeBase
Symbolrep

Request a governed re-review of this record. The record is not changed immediately.

Record
AUTOSAR/AP/record/SWS_TS_01261
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_TS_01261@rel:R25-11#7b8ecc44
Content hash
7b8ecc44
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_TimeSynchronization.pdf#nameddest=SWS_TS_01261
Status: valid/unmigrated Version: rel:R25-11#e1fffc65 Versionshistorie & Revisions (1 transition, 6 revision)
Current State
valid/unmigrated
Reason
mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record
Campaign
2026-08-13-status-backfill
Active Version
AUTOSAR/AP/record/SWS_TS_01261@rel:R25-11#e1fffc65
Point-in-Time History:
Recorded Revisions (6):
  • R25-11rel:R25-11#7b8ecc442026-09-30
  • R21-11rel:R21-11#354e4b092026-10-14
  • R22-11rel:R22-11#4f8ca1772026-10-14
  • R23-11rel:R23-11#ffbe9b8d2026-10-14
  • R24-11rel:R24-11#e1fffc652026-10-14
  • R25-11rel:R25-11#e1fffc652026-10-14 active
DateActorTransitionReason / RationaleCampaign
2026-08-13toolnone → valid/unmigratedmechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record2026-08-13-status-backfill

type alias time_point [SWS_TS_01264] Upstream: RS_AP_00130, RS_TS_00005 wording not yet imported

using time_point = std::chrono::time_point<TimeBase>;

represents a point in time

Header-Datei#include "ara/tsync/timestamp.h"
Scopestruct ara::tsync::TimeBase
Symboltime_point

Request a governed re-review of this record. The record is not changed immediately.

Record
AUTOSAR/AP/record/SWS_TS_01264
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_TS_01264@rel:R25-11#bb2caf41
Content hash
bb2caf41
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_TimeSynchronization.pdf#nameddest=SWS_TS_01264
Status: valid/unmigrated Version: rel:R25-11#611cfa6a Versionshistorie & Revisions (1 transition, 6 revision)
Current State
valid/unmigrated
Reason
mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record
Campaign
2026-08-13-status-backfill
Active Version
AUTOSAR/AP/record/SWS_TS_01264@rel:R25-11#611cfa6a
Point-in-Time History:
Recorded Revisions (6):
  • R25-11rel:R25-11#bb2caf412026-09-30
  • R21-11rel:R21-11#f0181e5d2026-10-14
  • R22-11rel:R22-11#1f9672ca2026-10-14
  • R23-11rel:R23-11#611cfa6a2026-10-14
  • R24-11rel:R24-11#611cfa6a2026-10-14
  • R25-11rel:R25-11#611cfa6a2026-10-14 active
DateActorTransitionReason / RationaleCampaign
2026-08-13toolnone → valid/unmigratedmechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record2026-08-13-status-backfill

Documentation of constants / variables

variable is_steady [SWS_TS_01265] Upstream: RS_AP_00130, RS_TS_00005 wording not yet imported

static constexpr bool is_steady = false;

required constant to fulfill the C++ Clock requirements as steady clock

Header-Datei#include "ara/tsync/timestamp.h"
Scopestruct ara::tsync::TimeBase
Symbolis_steady
Typbool

Request a governed re-review of this record. The record is not changed immediately.

Record
AUTOSAR/AP/record/SWS_TS_01265
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_TS_01265@rel:R25-11#bb6214b3
Content hash
bb6214b3
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_TimeSynchronization.pdf#nameddest=SWS_TS_01265
Status: valid/unmigrated Version: rel:R25-11#edb698f5 Versionshistorie & Revisions (1 transition, 6 revision)
Current State
valid/unmigrated
Reason
mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record
Campaign
2026-08-13-status-backfill
Active Version
AUTOSAR/AP/record/SWS_TS_01265@rel:R25-11#edb698f5
Point-in-Time History:
Recorded Revisions (6):
  • R25-11rel:R25-11#bb6214b32026-09-30
  • R21-11rel:R21-11#0d0dd4892026-10-14
  • R22-11rel:R22-11#c6a540902026-10-14
  • R23-11rel:R23-11#6b5858822026-10-14
  • R24-11rel:R24-11#edb698f52026-10-14
  • R25-11rel:R25-11#edb698f52026-10-14 active
DateActorTransitionReason / RationaleCampaign
2026-08-13toolnone → valid/unmigratedmechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record2026-08-13-status-backfill