Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/artfoxe6/cron_expression
:crying_cat_face: cron expression for golang, calculate the next time
https://github.com/artfoxe6/cron_expression
Last synced: about 1 month ago
JSON representation
:crying_cat_face: cron expression for golang, calculate the next time
- Host: GitHub
- URL: https://github.com/artfoxe6/cron_expression
- Owner: artfoxe6
- License: mit
- Created: 2020-05-06T11:40:58.000Z (over 4 years ago)
- Default Branch: master
- Last Pushed: 2020-05-29T12:51:46.000Z (over 4 years ago)
- Last Synced: 2024-09-24T09:21:58.154Z (3 months ago)
- Language: Go
- Homepage:
- Size: 47.9 KB
- Stars: 8
- Watchers: 1
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# cron_expression
Implemented the standard definition of cron expression
## Supported standard definitions
| Field | Required | Allowed values | Allowed special characters |
| ------------ | ------------ | ------------ | ------------ |
| Minutes | Yes | 0-59 | \* , - / |
| Hours | Yes | 0-23 | \* , - / |
| Day of month | Yes | 1-31 | \* , - / |
| Month | Yes | 1-12 or JAN-DEC | \* , - / |
| Day of week | Yes | 0-6 or SUN-SAT | \* , - / |
## Supported non-standard definitions
| Entry | Description | Equivalent to |
| ------ | ------ | ------ |
| @yearly (or @annually) | Run once a year at midnight of 1 January | 0 0 1 1 \* |
| @monthly | Run once a month at midnight of the first day of the month | 0 0 1 \* \* |
| @weekly | Run once a week at midnight on Sunday morning | 0 0 \* \* 0 |
| @daily (or @midnight) | Run once a day at midnight | 0 0 \* \* \* |
| @hourly | Run once an hour at the beginning of the hour | 0 \* \* \* \* |
## Install
```
go get github.com/artfoxe6/[email protected]
```
## Usage
func (expr *expression) Next(current time.Time) (*time.Time,error)
func (expr *expression) NextAny(current time.Time, nextStep int, dst *[]string) error
```go
package main
import (
"fmt"
"github.com/artfoxe6/cron_expression"
"log"
"time"
)
func main() {
expr := cron_expression.NewExpression("* 1-10/2 * */2 *", "CST", 8*3600)
next,err := expr.Next(time.Now())
if err != nil {
log.Fatalln(err.Error())
}
fmt.Println(next.Format("2006-01-02 15:04:05"))
}
```
```
2020-05-09 10:48:00
```
## Not Support Expression
| example | replace to |
| ------------ | ------------ |
| \* \* \*,27 \* \* | \* \* \* \* \* |
| \* 1-10/2,1,2,3 \* \* \* | \* 1,2,3,5,7,9 \* \* \* |
## Controversial
On the basis of standards:
If both dom and dow is not \*, anyone starts with \*/
The relationship becomes logical AND, Else logical OR
## Results verification
https://crontab.guru/
## references
https://en.wikipedia.org/wiki/Cron
https://pubs.opengroup.org/onlinepubs/007904975/utilities/crontab.html
https://crontab.guru/cron-bug.html
https://crontab.guru/tips.html