> Source: https://docs.cyberelements.io/identity/7.1/pt/UserDocumentation/AutomaticProvisioningConnectorsManagement/KeywordsInOperations/Dates/

# 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.
