[#BloombergLP-ball-FileObserver-rotateOnTimeInterval-02]
= xref:BloombergLP.adoc[BloombergLP]::xref:BloombergLP/ball.adoc[ball]::xref:BloombergLP/ball/FileObserver.adoc[FileObserver]::rotateOnTimeInterval
:relfileprefix: ../../../
:mrdocs:

`rotateOnTimeInterval` overloads

== Synopses

Declared in `<ball_fileobserver.h>`

Set this file observer to perform a periodic log file rotation at multiples of the specified `interval`. Optionally specify a `startTime` indicating the datetime to use as the starting point for computing the periodic rotation schedule. If `isPublishInLocalTimeEnabled` is `true`, the `startTime` is interpreted as local time, and as a UTC time otherwise. If `startTime` is not specified, the current time is used. This rule replaces any rotation‐on‐time‐interval rule currently in effect. The behavior is undefined unless `0 < interval.totalMilliseconds()`. Note that `startTime` may be a fixed time in the past; e.g., a reference time of `bdlt::Datetime(1, 1, 1)` and an interval of 24 hours would configure a periodic rotation at midnight each day.


[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
void
xref:BloombergLP/ball/FileObserver/rotateOnTimeInterval-00.adoc[rotateOnTimeInterval](xref:BloombergLP/bdlt/DatetimeInterval.adoc[bdlt::DatetimeInterval] const& interval);
----

[.small]#xref:BloombergLP/ball/FileObserver/rotateOnTimeInterval-00.adoc[_» more..._]#

Configure periodic log rotation with the specified `interval` and `startTime`.


[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
void
xref:BloombergLP/ball/FileObserver/rotateOnTimeInterval-0f.adoc[rotateOnTimeInterval](
    xref:BloombergLP/bdlt/DatetimeInterval.adoc[bdlt::DatetimeInterval] const& interval,
    xref:BloombergLP/bdlt/Datetime.adoc[bdlt::Datetime] const& startTime);
----

[.small]#xref:BloombergLP/ball/FileObserver/rotateOnTimeInterval-0f.adoc[_» more..._]#


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