[#absl-FromCivil]
= xref:absl.adoc[absl]::FromCivil
:relfileprefix: ../
:mrdocs:

Helper for TimeZone::At(CivilSecond) that provides "order‐preserving semantics." If the civil time maps to a unique time, that time is returned. If the civil time is repeated in the given time zone, the time using the pre‐transition offset is returned. Otherwise, the civil time is skipped in the given time zone, and the transition time is returned. This means that for any two civil times, ct1 and ct2, (ct1 < ct2) => (FromCivil(ct1) <= FromCivil(ct2)), the equal case being when two non‐existent civil times map to the same transition time.

== Synopsis

Declared in `<absl/time/time.h>`

[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
xref:absl/Time.adoc[Time]
FromCivil(
    xref:absl/CivilSecond.adoc[CivilSecond] ct,
    xref:absl/TimeZone.adoc[TimeZone] tz);
----

== Description

Note: Accepts civil times of any alignment.

== Return Value

The absolute time corresponding to `ct` in `tz`.

== Parameters

[cols="1,4"]
|===
| Name| Description
| *ct*
| The civil time to convert.
| *tz*
| The time zone to convert in.
|===


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