Funzioni di data

Completato

In Business Central la maggior parte dei dati è collegata alle date. Gli ordini di vendita, le fatture o le note di credito contengono date del documento, date di registrazione e una data di immissione. Le date sono presenti anche sul record del cliente.

Quando si elaborano le date nel codice, è possibile usare alcune funzioni di data per ottenere informazioni specifiche su una data o per modificare una data in un formato specifico.

Le funzioni di data usate in genere sono:

  • Date2DMY e Date2DWY

  • CalcDate

Le funzioni di data Today e Time restituiscono la data e l'ora correnti. La funzione WorkDate restituisce la data del lavoro impostata nell'applicazione.

Funzione Date2DMY

La funzione Date2DMY (o Date to Day, Month, Year, data per giorno, mese, anno) consente di ottenere parti specifiche di una determinata data.

Number := Date2DMY(Date, What);

Il parametro What specifica il risultato della funzione.

  • 1: corrisponde al giorno (1-31)

  • 2: corrisponde al mese (1-12)

  • 3: corrisponde all'anno

// TODAY IS 04/17/2020

Message('%1', Today()) ;
// Displays : 04/17/2020

MyDatePart := Date2DMY(Today(), 1) ;
Message('%1', MyDatePart) ;
// Displays : 17

MyDatePart := Date2DMY(Today(), 2) ;
Message('%1', MyDatePart) ;
// Displays : 4

Funzione Date2DWY

La funzione Date2DWY (o Date to Day, Week, Year, data per giorno, settimana, anno) consente di ottenere parti specifiche di una determinata data.

Number := Date2DWY(Date, What);

Il parametro What specifica il risultato della funzione.

  • 1: corrisponde al giorno della settimana (1-7, lunedì = 1)

  • 2: corrisponde al numero della settimana (1-53)

  • 3: corrisponde all'anno

// TODAY IS 04/17/2020

Message('%1', Today()) ;
// Displays : 04/17/2020

MyDatePart := Date2DWY(Today(), 1) ;
Message('%1', MyDatePart) ;
// Displays : 5

MyDatePart := Date2DWY(Today(), 2) ;
Message('%1', MyDatePart) ;
// Displays : 16

Funzione CalcDate

La funzione CalcDate consente di calcolare nuove date, a partire da una data specifica.

NewDate := CalcDate(DateExpression [, Date]);

Nel parametro DateExpression è possibile specificare il numero di giorni (D), settimane (W), mesi (M), trimestri (Q) o anni (Y) da aggiungere o sottrarre. Se non si specifica un parametro Date, viene usata la data di sistema corrente.

// TODAY IS 04/17/2020

Message('%1', Today()) ;
// Displays : 04/17/2020

Message('%1', CalcDate('1W', Today())) ;
// Displays : 04/24/2020