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

Add the specified field values to this time interval.

== Synopsis

Declared in `<bdlt_datetimeinterval.h>`

[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
xref:BloombergLP/bdlt/DatetimeInterval.adoc[DatetimeInterval]&
addInterval(
    int days,
    xref:BloombergLP/bsls/Types/Int64.adoc[bsls::Types::Int64] hours = 0,
    xref:BloombergLP/bsls/Types/Int64.adoc[bsls::Types::Int64] minutes = 0,
    xref:BloombergLP/bsls/Types/Int64.adoc[bsls::Types::Int64] seconds = 0,
    xref:BloombergLP/bsls/Types/Int64.adoc[bsls::Types::Int64] milliseconds = 0,
    xref:BloombergLP/bsls/Types/Int64.adoc[bsls::Types::Int64] microseconds = 0);
----

== Description

Add to this time interval the specified number of `days`, and the optionally specified number of `hours`, `minutes`, `seconds`, `milliseconds`, and `microseconds`, and return a reference providing modifiable access to this object. Unspecified arguments default to 0. The behavior is undefined unless the resulting time interval value is valid (i.e., the days field must not overflow a 32‐bit integer). Note that the arguments may be supplied using a mixture of positive, negative, and 0 values.

== Return Value

a reference providing modifiable access to this object

== Parameters

[cols="1,4"]
|===
| Name| Description
| *days*
| day count to add
| *hours*
| hour count to add (optional)
| *minutes*
| minute count to add (optional)
| *seconds*
| second count to add (optional)
| *milliseconds*
| millisecond count to add (optional)
| *microseconds*
| microsecond count to add (optional)
|===


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