krontab/kdocs/dev.inmo.krontab/create-simple-scheduler.html
2021-12-25 08:06:58 +00:00

42 lines
11 KiB
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" async="async"></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">kdocs</a></div>
<div>0.7.0</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"><script type="text/javascript" src="../../scripts/main.js"></script>
<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>/<a href="index.html">dev.inmo.krontab</a>/<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>incoming<span class="token operator">: </span><a href="index.html#-1448720714%2FClasslikes%2F788909594">KrontabTemplate</a><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">seconds</p></li><li><p class="paragraph">minutes</p></li><li><p class="paragraph">hours</p></li><li><p class="paragraph">dayOfMonth</p></li><li><p class="paragraph">month</p></li><li><p class="paragraph">(optional) year</p></li><li><p class="paragraph">(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) offset</p></li><li><p class="paragraph">(optional) (can be placed anywhere after month) dayOfWeek</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></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;1 2 3 F,4,L 5&quot; for triggering in near first second of second minute of third hour of fourth day 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 fourth day 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 fourth day 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 fourth day 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 fourth day 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 fourth day of may of 2021st year if it will be in Sunday-Tuesday week days with timezone UTC+01:00</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]?#com.soywiz.klock.TimezoneOffset/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"><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]?/PointingToDeclaration/">dev.inmo.krontab.internal.createKronScheduler</span></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>incoming<span class="token operator">: </span><a href="index.html#-1448720714%2FClasslikes%2F788909594">KrontabTemplate</a><span class="token punctuation">, </span>defaultOffset<span class="token operator">: </span><a href="../dev.inmo.krontab.utils/index.html#1215844957%2FClasslikes%2F788909594">Minutes</a><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>
</div>
<div class="footer"><span class="go-to-top-icon"><a href="#content" id="go-to-top-link"></a></span><span>© 2021 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>