DataWorks:Formatos de parâmetros de agendamento

Uso

Defina a lógica de atribuição de um parâmetro de agendamento especificando um nome de parâmetro e um valor de parâmetro na seção Scheduling Parameter > scheduling configuration. Após definir o parâmetro, referencie-o no código usando a sintaxe ${parameter name}. Para instruções detalhadas, consulte Configure and use scheduling parameters.

• Utilize os system built-in parameters $bizdate e $cyctime para representar a data de negócio e a hora agendada. Esses parâmetros resolvem para os seguintes valores:

  • $bizdate=${yyyymmdd}

  • $cyctime=$[yyyymmddhh24miss]

    Os exemplos anteriores mostram as definições de parâmetro para $bizdate (resolvendo para ${yyyymmdd} ) e $cyctime (resolvendo para $[yyyymmddhh24miss] ), além dos resultados de visualização quando a data de negócio é 2025-10-16.

• Caso os valores padrão de hora base não atendam às suas necessidades, utilize a sintaxe ${...} e $[...] para transformar as duas horas base em parâmetros de tempo personalizados.

Principais diferenças entre ${...} e $[...]

Os formatos ${...} e $[...] diferem em suas linhas de base de tempo e capacidades de cálculo. Misturá-los pode causar erros nos dados.

Formatação de tempo

Use os formatos ${...} ou $[...] para gerar parâmetros de tempo. Combine códigos de formato como yyyy, yy, mm e dd para gerar datas N anos, meses ou dias antes ou depois da data de negócio.

Cálculo de deslocamento

O cálculo de deslocamento permite adicionar ou subtrair tempo de uma data de negócio ou hora de agendamento. Aplique deslocamentos de N anos, meses, dias, horas ou minutos em relação à linha de base de tempo. Deslocamentos de hora e minuto são suportados apenas para a hora de agendamento. As capacidades de deslocamento de ${...} e $[...] diferem porque suportam níveis distintos de precisão de tempo.

1. Cálculo de deslocamento de ${...}

   • Capacidade principal: Suporta deslocamentos inteiros para anos, meses, semanas e dias.

     Importante

     Deslocamentos de horas e minutos não são suportados. Por exemplo, ${yyyy-mm-dd-1/24} é uma sintaxe inválida.

   • Sintaxe: ${<time_format><±N>}, onde a unidade de N é a menor unidade no formato, como yyyymm ou yyyymmdd.

     Requisito	Unidade de deslocamento	Sintaxe	Exemplo
     N anos antes/depois	Ano	${yyyy±N} ou ${yy±N}	Obter o ano anterior: ${yyyy-1}
     N meses antes/depois	Mês	${yyyymm±N}	Obter o mês anterior: ${yyyymm-1}
     N semanas antes/depois	Semana	${yyyymmdd±7*N}	Obter a semana anterior: ${yyyymmdd-7*1}
     N dias antes/depois	Dia	${yyyymmdd±N}	Obter o dia anterior: ${yyyymmdd-1}

2. Cálculo de deslocamento de $[...]

   • Capacidade principal: Suporta deslocamentos fracionários para dias, horas e minutos.

     Importante

     O formato $[...] não aceita expressões como $[yyyy-N] ou $[mm-N] para recuperar datas de N anos ou meses atrás. Para realizar deslocamentos de ano ou mês, use obrigatoriamente a função add_months.

   • Sintaxe: $[<time_format><±N>] , onde N representa uma fração de um dia: use N/24 para um deslocamento de N horas e N/24/60 para um deslocamento de N minutos.

     Requisito	Unidade de deslocamento	Sintaxe	Exemplo
     N anos antes/depois	Ano	N anos depois: $[add_months(yyyymmdd,12N)] N anos antes: $[add_months(yyyymmdd,-12N)]	Obter o ano anterior: $[add_months(yyyymmdd,-12)]
     N meses antes/depois	Mês	N meses depois: $[add_months(yyyymmdd,N)] N meses antes: $[add_months(yyyymmdd,-N)]	Obter o mês anterior: $[add_months(yyyymmdd,-1)] Obter o próximo mês: $[add_months(yyyy_mm,1)]
     N semanas antes/depois	Semana	$[yyyymmdd±7*N]	Obter a semana anterior: $[yyyymmdd-7*1]
     N dias antes/depois	Dia	$[yyyymmdd±N]	Obter o dia anterior (ontem): $[yyyymmdd-1]
     N horas antes/depois	Hora	Formatos disponíveis: $[hh24miss±N/24], $[hh24±N/24] $[<custom_time_format>±N/24]	Obter a hora anterior em diferentes formatos: Mês: $[mm-1/24] Ano: $[yyyy-1/24] Ano e mês: $[yyyymm-1/24] Ano, mês e dia: $[yyyymmdd-1/24] Dia anterior e hora anterior: $[yyyymmdd-1-1/24]
     N minutos antes/depois	Minuto	Formatos disponíveis: $[hh24miss±N/24/60] $[yyyymmddhh24miss±N/24/60] $[mi±N/24/60] $[<custom_time_format>±N/24/60]	Obter o horário 15 minutos antes da hora agendada em diferentes formatos: $[yyyy-15/24/60] $[yyyymm-15/24/60] $[yyyymmdd-15/24/60] $[hh24-15/24/60] $[mi-15/24/60]
     Deslocamento combinado	Dia + Hora	$[yyyymmdd±N±M/24], onde N é o deslocamento de dias e M é o deslocamento de horas.	Exemplo: Obter o horário do dia anterior e da hora anterior → $[yyyymmdd-1-1/24]

     Nota

     • Tratamento de mudança de dia: Deslocamentos de horas e minutos podem resultar em um horário que cruza o limite de um dia. Para detalhes sobre como lidar com isso, consulte How to handle cross-day parameter replacement when offsetting by one hour.

     • Calibração de fim de mês: Ao aplicar um deslocamento de mês a uma data de fim de mês, se o mês alvo tiver menos dias, o resultado será automaticamente calibrado para o último dia desse mês. Por exemplo, subtrair um mês de 2025-03-31 retorna 2025-02-28, pois fevereiro não tem 31 dias.

Transformação secundária usando funções do mecanismo

Se os recursos integrados de formatação e deslocamento não conseguirem produzir o valor exato necessário (por exemplo, o último dia do mês anterior), aplique uma transformação secundária usando as funções do mecanismo do nó ou um nó de atribuição.

Consulte: Typical scenarios for secondary processing of scheduling parameter return values .

Concatenação de strings

Utilize a concatenação de strings para construir strings de data estruturadas não suportadas pela sintaxe integrada. Esse método combina uma parte da data gerada por um parâmetro de agendamento com uma string constante.

Cenário 1: Agendamento normal

No agendamento normal, a substituição de parâmetros baseia-se em duas linhas de base de tempo: a data de negócio e a hora de agendamento.

• ${...} (data de negócio): O valor deriva da data de negócio da instância.

• $[...] (hora agendada): O valor deriva da hora de agendamento da instância.

Por exemplo, considere uma tarefa diária chamada A, agendada para execução às 00:00 com os seguintes parâmetros:

• yesterday=${yyyymmdd}

• today=$[yyyymmddhh24miss]

A tabela a seguir mostra como esses parâmetros são substituídos para uma instância específica:

Cenário 2: Backfill de dados

Durante um backfill de dados, a lógica de substituição de parâmetros muda com base na data de negócio selecionada. Isso afeta especialmente os parâmetros que dependem da hora de agendamento.

• ${...} (data de negócio): A linha de base é a data de negócio selecionada manualmente.

• $[...] (hora agendada): A linha de base é a data de negócio selecionada manualmente + 1 dia.

Por exemplo, se você fizer o backfill da tarefa A com 2025-03-15 como data de negócio: