Datas

CONVERDATE

Função que converte uma data para um formato definido. A data inicial pode estar em formato datetime ou em formato de cadeia de caracteres.

Sintaxe da função:

<CONVERTDATE:[src_date_format]:[dst_date_format]:[date_to_convert]>

• src_date_format: formato inicial da data que se vai converter.
• dst_date_format: formato de destino da data que se vai converter.
• src_date_format e dst_date_format:
  • DATE se o formato for filetime.
  • STR-[Date_mask]: indique o formato da data com a sintaxe seguinte:
    • DD: dia
    • HH: hora
    • MM: mês
    • SS: segundos
    • II: minutos
    • YY: ano
    • YYYY: ano
• date_to_convert: data que se vai converter.

Modo de utilização:

• A operação CONVERTDATE pode ser utilizada em todos os campos do tipo «expression», como as operações COPY, MODVALUE, etc. A conversão de uma data pode ser necessária durante o aprovisionamento para respeitar um formato de escrita esperado ou para a comparar com outra data.
• A data que se vai converter pode provir de um atributo e ser recuperada, por conseguinte, com as palavras-chave SyncAttSrc ou SyncAttDst.

Exemplos de configuração:

• <ConvertDate:DATE:STR-DD/MM/YYYY:<SyncAttSrc:contract_end_date>>
  • Com contract_end_date = «2022-01-12 15:30:39.503»
  • Resultado: 1/12/2022

CMPDATE

Função que compara duas datas. Devolve verdadeiro (1) ou falso (0) consoante o resultado da comparação:

• Se Operation = GT, a função devolve «true» se date_1 > date_2+delta
• Se Operation = LT, a função devolve «true» se date_1 < date_2+delta

Sintaxe da função:

<CMPDATE:[date_1]:[date_2]:[operation]:[delta]>

• Date_1: data a comparar com Date_2
• Date_2: data a comparar com Date_1
• Operation: pode assumir os valores seguintes
  • GT: equivale a «maior que»
  • LT: equivale a «menor que»
• Delta: número de dias a adicionar a date_2 para realizar a comparação. Introduza 0 se desejar comparar as datas tal como estão.

Modo de utilização:

• A operação CMPDATE pode ser utilizada em todos os campos do tipo «expression», como as operações COPY, MODVALUE, etc. Date_1 e date_2 devem estar no mesmo formato para que se possa realizar uma comparação. Consulte CONVERTDATE para converter um formato de data.
• As datas a comparar podem provir de um atributo e ser recuperadas, por conseguinte, com as palavras-chave SyncAttSrc ou SyncAttDst.
• As datas a comparar devem estar em formato filetime.

Exemplos de configuração:

• <CMPDate:<SyncAttSrc:contract_end_date>:<SyncAttSrc:date_fin>:GT:10>
  • Com contract_end_date = 01/12/2025 e end_date = 01/15/2025
  • Resultado = false
• <CMPDate:<SyncAttSrc:contract_end_date>:<SyncAttSrc:date_fin>:LT:0>
  • Com contract_end_date = 01/01/2025 e end_date = 01/15/2025
  • Resultado = true

CURRENTDATE

Devolve a data atual em formato «filetime».

Sintaxe da função:

<CURRENTDATE>

Modo de utilização:

• A palavra-chave CURRENTDATE utiliza-se em operações ou com outras palavras-chave, como CMPDATE ou CONVERTDATE.