12.10 SDK fieldAction: Format Date

Questa funzione SDK permette di convertire una qualsiasi data passata in input in un formato specifico.

Come primo parametro va passato il valore di un campo di un modulo o form dinamica contenente la data che si vuole formattare, invece come secondo parametro va passato il formato secondo le seguenti sintassi:

giorno / mese / anno(completo) -> d-m-Y
Esempio: 25-10-2024

mese / giorno / anno(completo) -> m-d-Y
Esempio: 10-25-2024

anno(completo) / mese / giorno -> Y-m-d
Esempio: 2024-10-25

anno(completo) / giorno / mese -> Y-d-m
Esempio: 2024-25-10

giorno / mese / anno(parziale) -> d-m-y
Esempio: 25-10-24

mese / giorno / anno(parziale) -> m-d-y
Esempio: 10-25-24

anno(parziale) / mese / giorno -> y-m-d
Esempio: 24-10-25

anno(parziale) / giorno / mese -> y-d-m
Esempio: 24-25-10

giorno / mese / anno(completo)  ore / minuti / secondi -> d-m-Y H:i:s
Esempio: 25-10-2024 16:32:20

mese / giorno / anno(completo)  ore / minuti / secondi -> m-d-Y H:i:s
Esempio: 10-25-2024 16:32:20

anno(completo) / mese / giorno  ore / minuti / secondi -> Y-m-d H:i:s
Esempio: 2024-10-25 16:32:20

anno(completo) / giorno / mese  ore / minuti / secondi -> Y-d-m H:i:s
Esempio: 2024-25-10 16:32:20

ore / minuti / secondi -> H:i:s
Esempio: 16:32:20

solo giorno -> d
Esempio: 25

solo mese -> m
Esempio: 10

solo anno(completo) -> Y
Esempio: 2024

solo anno(parziale) -> y
Esempio: 24

solo ore -> H
Esempio: 16

solo minuti -> i
Esempio: 32

solo secondi -> s
Esempio: 20

N.B: un risultato parziale non sarà gestibile all'interno di campi data o datetime, questo perché accettano solamente valori aventi almeno un giorno, mese e anno.

ESEMPIO DI UTILIZZO

Per comprenderne al meglio il funzionamento, qui di seguito viene riportato un esempio di utilizzo della funzione SDK formatDate() per la formattazione del valore del campo "Periodo Creazione" di un'istanza del modulo Aziende e il suo salvataggio all'interno di un campo di un process helper.

All'interno della form dinamica procediamo con la creazione di un campo data denominato "Data creazione" nel quale verrà salvato il risultato della funzione.
Successivamente andiamo a richiamare la funzione SDK interessata attraverso la picklist "Selezione Opzione" e ad accedere alla sezione "Funzioni data" (Figura 1)

Figura 1

Infine passiamo i parametri richiesti dalla funzione, tutti separati dalla virgola.
Nello specifico, come primo parametro inseriamo valore del campo "Periodo Creazione" (Figura 2)

Figura 2

Invece, come secondo parametro, passiamo il formato con il quale la funzione deve restituire la data, quindi nel nostro caso d-m-Y (Figura 3)

Figura 3

Il risultato sarà come quello mostrato in figura 4

Figura 4