Esta documentação foi traduzida automaticamente por IA.
CronJobManager é um gerenciador de tarefas agendadas fornecido pelo NocoBase, baseado em cron. Ele permite que os plugins registrem tarefas agendadas no servidor para executar lógicas específicas periodicamente.
A definição do tipo CronJobParameters é a seguinte (do cron):
| Parâmetro | Tipo | Descrição |
|---|---|---|
| cronTime | string | Date | DateTime | Expressão de tempo da tarefa agendada. Suporta expressões cron padrão, por exemplo, 0 0 * * * significa executar diariamente às 00:00. |
| onTick | function | Função principal da tarefa. Será acionada no horário especificado. |
| onComplete | function | Executa quando a tarefa é parada por job.stop() ou após a função onTick ser concluída. |
| timeZone | string | Especifica o fuso horário de execução (por exemplo, Asia/Shanghai). |
| context | any | Contexto ao executar onTick. |
| runOnInit | boolean | Indica se deve ser executado uma vez imediatamente na inicialização. |
| utcOffset | string | number | Especifica o deslocamento do fuso horário. |
| unrefTimeout | boolean | Controla se o loop de eventos permanece ativo. |
| Expressão | Significado |
|---|---|
* * * * * | Executa a cada minuto |
0 * * * * | Executa a cada hora |
0 0 * * * | Executa diariamente às 00:00 |
0 9 * * 1 | Executa toda segunda-feira às 09:00 |
*/10 * * * * | Executa a cada 10 minutos |
💡 Você pode usar crontab.guru para ajudar a gerar expressões.
As tarefas agendadas iniciam e param junto com a aplicação. Geralmente, você não precisa iniciá-las ou pará-las manualmente.