absl::FormatTime

std::string
FormatTime(
    std::string_view format,
    Time t,
    TimeZone tz);

Description

• %Ez - RFC3339-compatible numeric UTC offset (+hh:mm or -hh:mm)

• %E*z - Full-resolution numeric UTC offset (+hh:mm:ss or -hh:mm:ss)

• %E#S - Seconds with # digits of fractional precision

• %ES - Seconds with full fractional precision (a literal '')

• %E#f - Fractional seconds with # digits of precision

• %Ef - Fractional seconds with full precision (a literal '')

• %E4Y - Four-character years (-999 ... -001, 0000, 0001 ... 9999)

• %ET - The RFC3339 "date-time" separator "T"

Note that %E0S behaves like %S, and %E0f produces no characters. In contrast %E*f always produces at least one digit, which may be '0'.

Note that %Y produces as many characters as it takes to fully render the year. A year outside of [-999:9999]when formatted with %E4Y will produce more than four characters, just like %Y.

We recommend that format strings include the UTC offset (%z, %Ez, or %E*z) so that the result uniquely identifies a time instant.

Example:

absl::CivilSecond cs(2013, 1, 2, 3, 4, 5); absl::Time t = absl::FromCivil(cs, lax); std::string f = absl::FormatTime("%H:%M:%S", t, lax); // "03:04:05" f = absl::FormatTime("%H:%M:%E3S", t, lax); // "03:04:05.000"

Note: If the given absl::Time is absl::InfiniteFuture(), the returned string will be exactly "infinite-future". If the given absl::Time is absl::InfinitePast(), the returned string will be exactly "infinite-past". In both cases the given format string and absl::TimeZone are ignored.