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

This `struct` provides a namespace for a suite of non‐primitive functions providing conversions between absolute `Datetime` values and corresponding relative time intervals with respect to the Unix standard epoch time, returned by the `epoch` method. These methods are alias‐safe, thread‐safe, and exception‐neutral. Functions are provided for returning converted values by value or through a result pointer.

== Synopsis

Declared in `<bdlt_epochutil.h>`

[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
struct EpochUtil;
----

== Type Aliases

[cols="1,4"]
|===
| Name| Description
| xref:BloombergLP/bdlt/EpochUtil/TimeT64.adoc[`TimeT64`] 
| `TimeT64` is an alias for a 64‐bit integral type representing seconds from the epoch in UTC. Note that, in contrast with `bsl::time_t`, this type can be used in conversions to and from `Datetime` values that are less than the epoch (corresponding to negative `TimeT64` values).
|===


== Static Member Functions

[cols="1,4"]
|===
| Name| Description
| xref:BloombergLP/bdlt/EpochUtil/convertFromDatetimeInterval-03.adoc[`convertFromDatetimeInterval`] 
| `convertFromDatetimeInterval` overloads
| xref:BloombergLP/bdlt/EpochUtil/convertFromTimeInterval-00.adoc[`convertFromTimeInterval`] 
| `convertFromTimeInterval` overloads
| xref:BloombergLP/bdlt/EpochUtil/convertFromTimeT-05.adoc[`convertFromTimeT`] 
| `convertFromTimeT` overloads
| xref:BloombergLP/bdlt/EpochUtil/convertFromTimeT64-0a.adoc[`convertFromTimeT64`] 
| `convertFromTimeT64` overloads
| xref:BloombergLP/bdlt/EpochUtil/convertToDatetimeInterval-00.adoc[`convertToDatetimeInterval`] 
| `convertToDatetimeInterval` overloads
| xref:BloombergLP/bdlt/EpochUtil/convertToTimeInterval-0f.adoc[`convertToTimeInterval`] 
| `convertToTimeInterval` overloads
| xref:BloombergLP/bdlt/EpochUtil/convertToTimeT-05.adoc[`convertToTimeT`] 
| `convertToTimeT` overloads
| xref:BloombergLP/bdlt/EpochUtil/convertToTimeT64-04.adoc[`convertToTimeT64`] 
| `convertToTimeT64` overloads
| xref:BloombergLP/bdlt/EpochUtil/epoch.adoc[`epoch`] 
| Return a reference providing non‐modifiable access to the epoch time: midnight on January 1, 1970. Note that this value exists before any code is executed and will continue to exist, unchanged, until the program exits.
|===



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