krontab/kdocs/dev.inmo.krontab/create-simple-scheduler.html
2022-06-15 08:50:33 +00:00

89 lines
14 KiB
HTML

<!DOCTYPE html>
<html>
<head>
<meta name="viewport" content="width=device-width, initial-scale=1" charset="UTF-8">
<title>createSimpleScheduler</title>
<link href="../../images/logo-icon.svg" rel="icon" type="image/svg">
<script>var pathToRoot = "../../";</script>
<script>const storage = localStorage.getItem("dokka-dark-mode")
const savedDarkMode = storage ? JSON.parse(storage) : false
if(savedDarkMode === true){
document.getElementsByTagName("html")[0].classList.add("theme-dark")
}</script>
<script type="text/javascript" src="../../scripts/sourceset_dependencies.js" async="async"></script>
<link href="../../styles/style.css" rel="Stylesheet">
<link href="../../styles/jetbrains-mono.css" rel="Stylesheet">
<link href="../../styles/main.css" rel="Stylesheet">
<link href="../../styles/prism.css" rel="Stylesheet">
<link href="../../styles/logo-styles.css" rel="Stylesheet">
<script type="text/javascript" src="../../scripts/clipboard.js" async="async"></script>
<script type="text/javascript" src="../../scripts/navigation-loader.js" async="async"></script>
<script type="text/javascript" src="../../scripts/platform-content-handler.js" async="async"></script>
<script type="text/javascript" src="../../scripts/main.js" defer="defer"></script>
<script type="text/javascript" src="../../scripts/prism.js" async="async"></script>
</head>
<body>
<div class="navigation-wrapper" id="navigation-wrapper">
<div id="leftToggler"><span class="icon-toggler"></span></div>
<div class="library-name">
<a href="../../index.html">
<span>kdocs</span>
</a>
</div>
<div>
0.7.3 </div>
<div class="pull-right d-flex">
<div class="filter-section" id="filter-section">
<button class="platform-tag platform-selector common-like" data-active="" data-filter=":dokkaHtml/commonMain">common</button>
</div>
<button id="theme-toggle-button"><span id="theme-toggle"></span></button>
<div id="searchBar"></div>
</div>
</div>
<div id="container">
<div id="leftColumn">
<div id="sideMenu"></div>
</div>
<div id="main">
<div class="main-content" id="content" pageIds="kdocs::dev.inmo.krontab//createSimpleScheduler/#kotlin.String/PointingToDeclaration//788909594">
<div class="breadcrumbs"><a href="../../index.html">kdocs</a><span class="delimiter">/</span><a href="index.html">dev.inmo.krontab</a><span class="delimiter">/</span><a href="create-simple-scheduler.html">createSimpleScheduler</a></div>
<div class="cover ">
<h1 class="cover"><span>create</span><wbr></wbr><span>Simple</span><wbr></wbr><span><span>Scheduler</span></span></h1>
</div>
<div class="platform-hinted with-platform-tabs" data-platform-hinted="data-platform-hinted">
<div class="platform-bookmarks-row" data-toggle-list="data-toggle-list"><button class="platform-bookmark common-like" data-filterable-current=":dokkaHtml/commonMain" data-filterable-set=":dokkaHtml/commonMain" data-active="" data-toggle=":dokkaHtml/commonMain">common</button></div>
<div class="content sourceset-depenent-content" data-active="" data-togglable=":dokkaHtml/commonMain"><div class="symbol monospace"><span class="token keyword"></span><span class="token keyword">fun </span><a href="create-simple-scheduler.html"><span class="token function">createSimpleScheduler</span></a><span class="token punctuation">(</span><span class="parameters "><span class="parameter ">incoming<span class="token operator">: </span><a href="index.html#-1448720714%2FClasslikes%2F788909594">KrontabTemplate</a></span></span><span class="token punctuation">)</span><span class="token operator">: </span><a href="-kron-scheduler/index.html">KronScheduler</a><span class="top-right-position"><span class="copy-icon"></span><div class="copy-popup-wrapper popup-to-left"><span class="copy-popup-icon"></span><span>Content copied to clipboard</span></div></span></div><p class="paragraph">Parse <a href="create-simple-scheduler.html">incoming</a> string and adapt according to next format: &quot;* * * * *&quot; where order of things:</p><ul><li><p class="paragraph"><strong>seconds</strong></p></li><li><p class="paragraph"><strong>minutes</strong></p></li><li><p class="paragraph"><strong>hours</strong></p></li><li><p class="paragraph"><strong>dayOfMonth</strong></p></li><li><p class="paragraph"><strong>month</strong></p></li><li><p class="paragraph"><strong>year</strong> (optional)</p></li><li><p class="paragraph"><strong>offset</strong> (optional) (can be placed anywhere after month) (must be marked with <code class="lang-kotlin">o</code> at the end, for example: 60o == +01:00)</p></li><li><p class="paragraph"><strong>dayOfWeek</strong> (optional) (can be placed anywhere after month)</p></li><li><p class="paragraph"><strong>milliseconds</strong> (optional) (can be placed anywhere after month) (must be marked with <code class="lang-kotlin">ms</code> at the end, for example: 500ms; 100-200ms)</p></li></ul><p class="paragraph">And each one (except of offsets) have next format:</p><p class="paragraph"><code class="lang-kotlin">{number}[,{number},...]</code> or <code class="lang-kotlin">*</code></p><p class="paragraph">and {number} here is one of</p><ul><li><p class="paragraph">{int}-{int}</p></li><li><p class="paragraph">{int}/{int}</p></li><li><p class="paragraph">*/{int}</p></li><li><p class="paragraph">{int}</p></li><li><p class="paragraph">F</p></li><li><p class="paragraph">L</p></li></ul><p class="paragraph">Week days must be marked with <code class="lang-kotlin">w</code> at the end, and starts with 0 which means Sunday. For example, 0w == Sunday. With weeks you can use syntax like with any number like seconds, for example: 0-2w means Sunday-Tuesday</p><p class="paragraph">Additional info about ranges can be found in follow accordance:</p><ul><li><p class="paragraph">Seconds ranges can be found in <span data-unresolved-link="dev.inmo.krontab.internal//secondsRange/#/PointingToDeclaration/">secondsRange</span></p></li><li><p class="paragraph">Minutes ranges can be found in <span data-unresolved-link="dev.inmo.krontab.internal//minutesRange/#/PointingToDeclaration/">minutesRange</span></p></li><li><p class="paragraph">Hours ranges can be found in <span data-unresolved-link="dev.inmo.krontab.internal//hoursRange/#/PointingToDeclaration/">hoursRange</span></p></li><li><p class="paragraph">Days of month ranges can be found in <span data-unresolved-link="dev.inmo.krontab.internal//dayOfMonthRange/#/PointingToDeclaration/">dayOfMonthRange</span></p></li><li><p class="paragraph">Months ranges can be found in <span data-unresolved-link="dev.inmo.krontab.internal//monthRange/#/PointingToDeclaration/">monthRange</span></p></li><li><p class="paragraph">Years ranges can be found in <span data-unresolved-link="dev.inmo.krontab.internal//yearRange/#/PointingToDeclaration/">yearRange</span> (in fact - any <a href="https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-int/index.html">Int</a>)</p></li><li><p class="paragraph">WeekDay (timezone) ranges can be found in <span data-unresolved-link="dev.inmo.krontab.internal//dayOfWeekRange/#/PointingToDeclaration/">dayOfWeekRange</span></p></li><li><p class="paragraph">Milliseconds ranges can be found in <span data-unresolved-link="dev.inmo.krontab.internal//millisecondsRange/#/PointingToDeclaration/">millisecondsRange</span></p></li></ul><p class="paragraph">Examples:</p><ul><li><p class="paragraph">&quot;0/5 * * * *&quot; for every five seconds triggering</p></li><li><p class="paragraph">&quot;0/5,L * * * *&quot; for every five seconds triggering and on 59 second</p></li><li><p class="paragraph">&quot;0/15 30 * * *&quot; for every 15th seconds in a half of each hour</p></li><li><p class="paragraph">&quot;0/15 30 * * * 500ms&quot; for every 15th seconds in a half of each hour when milliseconds equal to 500</p></li><li><p class="paragraph">&quot;1 2 3 F,4,L 5&quot; for triggering in near first second of second minute of third hour of first, fifth and last days of may</p></li><li><p class="paragraph">&quot;1 2 3 F,4,L 5 60o&quot; for triggering in near first second of second minute of third hour of first, fifth and last days of may with timezone UTC+01:00</p></li><li><p class="paragraph">&quot;1 2 3 F,4,L 5 60o 0-2w&quot; for triggering in near first second of second minute of third hour of first, fifth and last days of may in case if it will be in Sunday-Tuesday week days with timezone UTC+01:00</p></li><li><p class="paragraph">&quot;1 2 3 F,4,L 5 2021&quot; for triggering in near first second of second minute of third hour of first, fifth and last days of may of 2021st year</p></li><li><p class="paragraph">&quot;1 2 3 F,4,L 5 2021 60o&quot; for triggering in near first second of second minute of third hour of first, fifth and last days of may of 2021st year with timezone UTC+01:00</p></li><li><p class="paragraph">&quot;1 2 3 F,4,L 5 2021 60o 0-2w&quot; for triggering in near first second of second minute of third hour of first, fifth and last days of may of 2021st year if it will be in Sunday-Tuesday week days with timezone UTC+01:00</p></li><li><p class="paragraph">&quot;1 2 3 F,4,L 5 2021 60o 0-2w 500ms&quot; for triggering in near first second of second minute of third hour of first, fifth and last days of may of 2021st year if it will be in Sunday-Tuesday week days with timezone UTC+01:00 when milliseconds will be equal to 500</p></li></ul><h4 class="">Return</h4><p class="paragraph">In case when offset parameter is absent in <a href="create-simple-scheduler.html">incoming</a> will be used <a href="create-simple-scheduler.html">createSimpleScheduler</a> method and returned <span data-unresolved-link="dev.inmo.krontab.internal/CronDateTimeScheduler///PointingToDeclaration/">CronDateTimeScheduler</span>. In case when offset parameter there is in <a href="index.html#-1448720714%2FClasslikes%2F788909594">incoming</a> will be used <span data-unresolved-link="dev.inmo.krontab.internal//createKronSchedulerWithOffset/#kotlin.Array[kotlin.Byte]?#kotlin.Array[kotlin.Byte]?#kotlin.Array[kotlin.Byte]?#kotlin.Array[kotlin.Byte]?#kotlin.Array[kotlin.Byte]?#kotlin.Array[kotlin.Int]?#kotlin.Array[kotlin.Byte]?#TimezoneOffset#kotlin.Array[kotlin.Short]?/PointingToDeclaration/">createKronSchedulerWithOffset</span> and returned <span data-unresolved-link="dev.inmo.krontab.internal/CronDateTimeSchedulerTz///PointingToDeclaration/">CronDateTimeSchedulerTz</span></p><h2 class="">See also</h2><div data-togglable="See also"><div class="table" data-togglable="See also"><div class="table-row" data-filterable-current=":dokkaHtml/commonMain" data-filterable-set=":dokkaHtml/commonMain"><div class="main-subrow keyValue WithExtraAttributes"><div class=""><span class="inline-flex"><div><span data-unresolved-link="dev.inmo.krontab.internal//createKronScheduler/#kotlin.Array[kotlin.Byte]?#kotlin.Array[kotlin.Byte]?#kotlin.Array[kotlin.Byte]?#kotlin.Array[kotlin.Byte]?#kotlin.Array[kotlin.Byte]?#kotlin.Array[kotlin.Int]?#kotlin.Array[kotlin.Byte]?#kotlin.Array[kotlin.Short]?/PointingToDeclaration/"><span>dev.</span><wbr></wbr><span>inmo.</span><wbr></wbr><span>krontab.</span><wbr></wbr><span>internal.</span><wbr></wbr><span>create</span><wbr></wbr><span>Kron</span><wbr></wbr><span><span>Scheduler</span></span></span></div></span></div><div><div class="title"><div data-togglable="See also"></div></div></div></div></div></div></div><br><div class="symbol monospace"><span class="token keyword"></span><span class="token keyword">fun </span><a href="create-simple-scheduler.html"><span class="token function">createSimpleScheduler</span></a><span class="token punctuation">(</span><span class="parameters "><span class="parameter ">incoming<span class="token operator">: </span><a href="index.html#-1448720714%2FClasslikes%2F788909594">KrontabTemplate</a><span class="token punctuation">, </span></span><span class="parameter ">defaultOffset<span class="token operator">: </span><a href="../dev.inmo.krontab.utils/index.html#1215844957%2FClasslikes%2F788909594">Minutes</a></span></span><span class="token punctuation">)</span><span class="token operator">: </span><a href="-kron-scheduler-tz/index.html">KronSchedulerTz</a><span class="top-right-position"><span class="copy-icon"></span><div class="copy-popup-wrapper popup-to-left"><span class="copy-popup-icon"></span><span>Content copied to clipboard</span></div></span></div></div> </div>
<h2 class="">Sources</h2>
<div class="table" data-togglable="Sources"><a data-name="-1214228491%2FSource%2F788909594" anchor-label="https://github.com/InsanusMokrassar/krontab/blob/master//src/commonMain/kotlin/dev/inmo/krontab/StringParser.kt#L14" id="-1214228491%2FSource%2F788909594" data-filterable-set=":dokkaHtml/commonMain"></a>
<div class="table-row" data-filterable-current=":dokkaHtml/commonMain" data-filterable-set=":dokkaHtml/commonMain">
<div class="main-subrow keyValue ">
<div class=""><span class="inline-flex">
<div><a href="https://github.com/InsanusMokrassar/krontab/blob/master//src/commonMain/kotlin/dev/inmo/krontab/StringParser.kt#L14">common source</a></div>
<span class="anchor-wrapper"><span class="anchor-icon" pointing-to="-1214228491%2FSource%2F788909594"></span>
<div class="copy-popup-wrapper "><span class="copy-popup-icon"></span><span>Link copied to clipboard</span></div>
</span></span></div>
<div></div>
</div>
</div>
<a data-name="-1214228491%2FSource%2F788909594" anchor-label="https://github.com/InsanusMokrassar/krontab/blob/master//src/commonMain/kotlin/dev/inmo/krontab/StringParser.kt#L133" id="-1214228491%2FSource%2F788909594" data-filterable-set=":dokkaHtml/commonMain"></a>
<div class="table-row" data-filterable-current=":dokkaHtml/commonMain" data-filterable-set=":dokkaHtml/commonMain">
<div class="main-subrow keyValue ">
<div class=""><span class="inline-flex">
<div><a href="https://github.com/InsanusMokrassar/krontab/blob/master//src/commonMain/kotlin/dev/inmo/krontab/StringParser.kt#L133">common source</a></div>
<span class="anchor-wrapper"><span class="anchor-icon" pointing-to="-1214228491%2FSource%2F788909594"></span>
<div class="copy-popup-wrapper "><span class="copy-popup-icon"></span><span>Link copied to clipboard</span></div>
</span></span></div>
<div></div>
</div>
</div>
</div>
</div>
<div class="footer"><span class="go-to-top-icon"><a href="#content" id="go-to-top-link"></a></span><span>© 2022 Copyright</span><span
class="pull-right"><span>Generated by </span><a
href="https://github.com/Kotlin/dokka"><span>dokka</span><span class="padded-icon"></span></a></span>
</div>
</div>
</div>
</body>
</html>