> Source: https://docs.cyberelements.io/identity/7.0/cs/UserDocumentation/AutomaticProvisioningConnectorsManagement/KeywordsInOperations/Dates/

# Kalendářní data

## CONVERDATE

Funkce, která převede datum do definovaného formátu. Počáteční datum může být ve formátu datetime nebo ve formě řetězce znaků.

**Syntaxe funkce:**

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

- src_date_format: počáteční formát převáděného data.
- dst_date_format: cílový formát převáděného data.
- src_date_format a dst_date_format:
    - DATE, pokud je formát filetime.
    - STR-[Date_mask]: zadejte formát data pomocí následující syntaxe:
        - DD: den
        - HH: hodina
        - MM: měsíc
        - SS: sekundy
        - II: minuty
        - YY: rok
        - YYYY: rok
- date_to_convert: převáděné datum.

**Způsob použití:**

- Operaci CONVERTDATE lze použít ve všech polích typu „expression“, například v operacích COPY, MODVALUE atd. Převod data může být při zřizování nutný, aby byl dodržen očekávaný formát zápisu pro porovnání s jiným datem.
- Převáděné datum může pocházet z atributu, a lze jej proto načíst pomocí klíčových slov SyncAttSrc nebo SyncAttDst.

**Příklady konfigurace:**

- <ConvertDate:DATE:STR-DD/MM/YYYY:<SyncAttSrc:contract_end_date>>
    - Pro contract_end_date = „2022-01-12 15:30:39.503“
    - Výsledek: 1/12/2022

## CMPDATE

Funkce, která porovná dvě data. Podle výsledku porovnání vrátí hodnotu true (1) nebo false (0):

- Pokud Operation = GT, funkce vrátí „true“, jestliže date_1 > date_2+delta
- Pokud Operation = LT, funkce vrátí „true“, jestliže date_1 < date_2+delta

**Syntaxe funkce:**

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

- Date_1: datum, které se porovnává s Date_2
- Date_2: datum, které se porovnává s Date_1
- Operation: může nabývat následujících hodnot
    - GT: odpovídá „větší než“
    - LT: odpovídá „menší než“
- Delta: počet dní, které se přičtou k date_2 pro provedení porovnání. Chcete-li porovnat data tak, jak jsou, zadejte 0.

**Způsob použití:**

- Operaci CMPDATE lze použít ve všech polích typu „expression“, například v operacích COPY, MODVALUE atd. Date_1 a date_2 musí být ve stejném formátu, aby bylo možné provést porovnání. Pro převod formátu data viz CONVERTDATE.
- Porovnávaná data mohou pocházet z atributu, a lze je proto načíst pomocí klíčových slov SyncAttSrc nebo SyncAttDst.
- Porovnávaná data musí být ve formátu filetime.

**Příklady konfigurace:**

- <CMPDate:<SyncAttSrc:contract_end_date>:<SyncAttSrc:date_fin>:GT:10>
    - Pro contract_end_date = 01/12/2025 a end_date = 01/15/2025
    - Výsledek = false
- <CMPDate:<SyncAttSrc:contract_end_date>:<SyncAttSrc:date_fin>:LT:0>
    - Pro contract_end_date = 01/01/2025 a end_date = 01/15/2025
    - Výsledek = true

## CURRENTDATE

Vrátí aktuální datum ve formátu „filetime“.

**Syntaxe funkce:**

<CURRENTDATE>

**Způsob použití:**

- Klíčové slovo CURRENTDATE se používá v operacích nebo s jinými klíčovými slovy, jako je CMPDATE nebo CONVERTDATE.
