DTADD: Incremento di un componente data o data-ora

Data una data in formato data standard o data-ora, DTADD restituisce una nuova data dopo aver aggiunto il numero specificato o un componente supportato. Il formato data restituito è l stesso del formato data d'immissione.

Sintassi: Come incrementare un componente data o data-ora

DTADD(date, component, increment)

dove:

data

Data o data-ora

Valore data-ora o data da incrementare.

componente

Parola chiave

Il componente da incrementare. Componenti validi (e valori accettabili) sono:

YEAR (1-9999)
QUARTER (1-4)
MONTH (1-12)
WEEK (1-53). Questo elemento viene influenzato dall'impostazione WEEKFIRST.
DAY (del mese, 1-31)
HOUR (0-23)
MINUTE (0-59)
SECOND (0-59)

incrementazione

Valore intero

Il valore (negativo o positivo) da aggiungere al componente.

Inizio pagina

Esempio: incremento del componente DAY di una data

La seguente richiesta rispetto all'origine dati WF_RETAIL aggiunge tre giorni alla data di nascita dei dipendenti:

DEFINE FILE WF_RETAIL
NEWDATE/YYMD = DTADD(DATE_OF_BIRTH, DAY, 3);
MGR/A3 = DIGITS(ID_MANAGER, 3);
END
TABLE FILE WF_RETAIL
SUM MGR NOPRINT DATE_OF_BIRTH NEWDATE
BY MGR
ON TABLE SET PAGE NOPAGE
END

L'emissione è:

Riferimento: Note per l'uso per DTADD

È possibile manipolare ogni elemento in modo separato. Quindi, se si desidera aggiungere 1 anno e 1 giorno ad una data, è necessario chiamare la funzione due volte, una per YEAR (è necessario eseguire l'anno bisestile) e uno per DAY. È possibile annidare le funzioni semplificate in una sola espressione, o crearle e applicarle in espressioni DEFINE O COMPUTE separate.
Con riguardo alla convalida dei parametri, DTADD non consentirà nulla ma solamente l'uso di una data standard o data-ora nel primo parametro.
L'incremento non è selezionato e l'utente dovrebbe essere a conoscenza che i numeri decimali non sono supportati e verranno troncati. Qualsiasi combinazione di valori che aumenta YEAR oltre a 9999 resituisce la data di immissione come il valor e senza messaggio. Se l'utente riceve la data di immissione quando si aspetta qualcos'altro, è possiible che ci sia stato un errore.