[#BloombergLP-bdlt-EpochUtil-convertToTimeT-00]
= xref:BloombergLP.adoc[BloombergLP]::xref:BloombergLP/bdlt.adoc[bdlt]::xref:BloombergLP/bdlt/EpochUtil.adoc[EpochUtil]::convertToTimeT
:relfileprefix: ../../../
:mrdocs:

Return the relative time computed as the difference between the specified absolute `datetime` and the epoch. The behavior is undefined unless `datetime ‐ epoch() >= DatetimeInterval()` and the converted `datetime` can be represented in the destination format on all supported platforms (i.e., the resultant value is representable as a 32‐bit `int`). Note that `datetime` is assumed to use Coordinated Universal Time (UTC) as a reference. Also note that if error detection is desired, the overloaded version that loads the converted `datetime` into a supplied destination object should be used.

== Synopsis

Declared in `<bdlt_epochutil.h>`

[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
static
std::time_t
convertToTimeT(xref:BloombergLP/bdlt/Datetime.adoc[Datetime] const& datetime);
----


[.small]#Created with https://www.mrdocs.com[MrDocs]#