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

Write a textual representation of this time into `result`.

== Synopsis

Declared in `<bdlt_time.h>`

[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
int
printToBuffer(
    char* result,
    int numBytes,
    int fractionalSecondPrecision = 6) const;
----

== Description

Efficiently write to the specified `result` buffer no more than the specified `numBytes` of a representation of the value of this object. Optionally specify `fractionalSecondPrecision` digits to indicate how many fractional second digits to output. If `fractionalSecondPrecision` is not specified then 6 fractional second digits will be output (3 digits for milliseconds and 3 digits for microseconds). Return the number of characters (not including the null character) that would have been written if the limit due to `numBytes` were not imposed. `result` is null‐terminated unless `numBytes` is 0. The behavior is undefined unless `0 <= numBytes`, `0 <= fractionalSecondPrecision <= 6`, and `result` refers to at least `numBytes` contiguous bytes. Note that the return value is greater than or equal to `numBytes` if the output representation was truncated to avoid `result` overrun.

== Return Value

the number of characters that would have been written

== Parameters

[cols="1,4"]
|===
| Name| Description
| *result*
| output buffer
| *numBytes*
| maximum number of bytes to write
| *fractionalSecondPrecision*
| fractional second digits (default 6)
|===


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