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

`ParseTime` overloads

== Synopses

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

Parses an input string according to the provided format string and returns the corresponding `absl::Time`. Uses strftime()‐like formatting options, with the same extensions as FormatTime(), but with the exceptions that %E#S is interpreted as %E_S, and %E#f as %E_f. %Ez and %E*z also accept the same inputs, which (along with %z) includes 'z' and 'Z' as synonyms for +00:00. %ET accepts either 'T' or 't'.


[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
bool
xref:absl/ParseTime-06.adoc[ParseTime](
    std::string_view format,
    std::string_view input,
    xref:absl/Time.adoc[Time]* time,
    std::string* err);
----

[.small]#xref:absl/ParseTime-06.adoc[_» more..._]#

Like ParseTime() above, but if the format string does not contain a UTC offset specification (%z/%Ez/%E*z) then the input is interpreted in the given TimeZone. This means that the input, by itself, does not identify a unique instant. Being time‐zone dependent, it also admits the possibility of ambiguity or non‐existence, in which case the "pre" time (as defined by TimeZone::TimeInfo) is returned. For these reasons we recommend that all date/time strings include a UTC offset so they're context independent.


[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
bool
xref:absl/ParseTime-00.adoc[ParseTime](
    std::string_view format,
    std::string_view input,
    xref:absl/TimeZone.adoc[TimeZone] tz,
    xref:absl/Time.adoc[Time]* time,
    std::string* err);
----

[.small]#xref:absl/ParseTime-00.adoc[_» more..._]#

== Return Value

`true` upon successful parsing.

== Parameters

[cols="1,4"]
|===
| Name| Description
| *format*
| The strftime()‐like format string.
| *input*
| The string to parse.
| *time*
| Output parameter receiving the parsed time.
| *err*
| Output parameter receiving an error message on failure.
| *tz*
| The time zone to interpret the input in when no offset is present.
|===


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