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

# Päivämäärät

## CONVERDATE

Funktio, joka muuntaa päivämäärän määritettyyn muotoon. Alkuperäinen päivämäärä voi olla datetime-muodossa tai merkkijonona.

**Funktion syntaksi:**

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

- src_date_format: muunnettavan päivämäärän alkuperäinen muoto.
- dst_date_format: muunnettavan päivämäärän kohdemuoto.
- src_date_format ja dst_date_format:
    - DATE, jos muoto on filetime.
    - STR-[Date_mask]: ilmoita päivämäärän muoto seuraavalla syntaksilla:
        - DD: päivä
        - HH: tunti
        - MM: kuukausi
        - SS: sekunnit
        - II: minuutit
        - YY: vuosi
        - YYYY: vuosi
- date_to_convert: muunnettava päivämäärä.

**Käyttötapa:**

- Toimintoa CONVERTDATE voi käyttää kaikissa tyypin ”expression” kentissä, kuten toiminnoissa COPY, MODVALUE jne. Päivämäärän muunnos voi olla provisioinnissa tarpeen, jotta noudatetaan odotettua kirjoitusmuotoa tai jotta päivämäärää voi verrata toiseen päivämäärään.
- Muunnettava päivämäärä voi tulla attribuutista, ja se voidaan siksi hakea avainsanoilla SyncAttSrc tai SyncAttDst.

**Määritysesimerkkejä:**

- <ConvertDate:DATE:STR-DD/MM/YYYY:<SyncAttSrc:contract_end_date>>
    - Kun contract_end_date = ”2022-01-12 15:30:39.503”
    - Tulos: 1/12/2022

## CMPDATE

Funktio, joka vertaa kahta päivämäärää. Se palauttaa vertailun tuloksen mukaan tosi (1) tai epätosi (0):

- Jos Operation = GT, funktio palauttaa ”true”, kun date_1 > date_2+delta
- Jos Operation = LT, funktio palauttaa ”true”, kun date_1 < date_2+delta

**Funktion syntaksi:**

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

- Date_1: päivämäärä, jota verrataan Date_2:een
- Date_2: päivämäärä, jota verrataan Date_1:een
- Operation: voi saada seuraavat arvot
    - GT: vastaa ilmausta ”greater than”
    - LT: vastaa ilmausta ”less than”
- Delta: päivien määrä, joka lisätään date_2:een vertailun tekemiseksi. Kirjoita 0, jos haluat verrata päivämääriä sellaisinaan.

**Käyttötapa:**

- Toimintoa CMPDATE voi käyttää kaikissa tyypin ”expression” kentissä, kuten toiminnoissa COPY, MODVALUE jne. Date_1:n ja date_2:n on oltava samassa muodossa, jotta vertailu on mahdollinen. Katso CONVERTDATE, kun haluat muuntaa päivämäärän muotoa.
- Verrattavat päivämäärät voivat tulla attribuutista, ja ne voidaan siksi hakea avainsanoilla SyncAttSrc tai SyncAttDst.
- Verrattavien päivämäärien on oltava filetime-muodossa.

**Määritysesimerkkejä:**

- <CMPDate:<SyncAttSrc:contract_end_date>:<SyncAttSrc:date_fin>:GT:10>
    - Kun contract_end_date = 01/12/2025 ja end_date = 01/15/2025
    - Tulos = false
- <CMPDate:<SyncAttSrc:contract_end_date>:<SyncAttSrc:date_fin>:LT:0>
    - Kun contract_end_date = 01/01/2025 ja end_date = 01/15/2025
    - Tulos = true

## CURRENTDATE

Palauttaa nykyisen päivämäärän muodossa ”filetime”.

**Funktion syntaksi:**

<CURRENTDATE>

**Käyttötapa:**

- Avainsanaa CURRENTDATE käytetään toiminnoissa tai muiden avainsanojen, kuten CMPDATE tai CONVERTDATE, kanssa.
