Funzioni Data e Ora Standard specifiche-Maintain

In questa sezione:

 

Le funzioni data ee ora standard sono di uso con date non legacy. Per uan definizione delle date e orari standard, consultare Funzioni Data-Ora.

Inizio pagina
x
HHMMSS: Recupero dell’ora corrente (Maintain)

Come:

La funzione HHMMSS recupera l'ora corrente dal sistema operativo come una stringa di 8 caratteri, separando le ore, i minuti e i secondi con dei punti.

Per usare questa funzione, è necessario importare la funzione libreria MNTUWS. Per informazioni sull'importazione di una libreria di funzione, consultare Chiamata di una funzione.

È inoltre disponibile una funzione HHMMSS nel linguaggio di reporting. Per informazioni su questa funzione, consultare HHMMSS: Richiamo dell’ora corrente.
x
Sintassi: Come Richiama l’ora corrente
HHMMSS()
Esempio: Richiamo dell’ora corrente

HHMMSS recupera l'ora corrente dal sistema operativo: 

MAINTAIN
Module Import (mntuws);
Case Top
Compute now/a10 = hhmmss();
type "Now = <<now"
EndCase
END

L'emissione è:

Now = 14.25.33
Inizio pagina
x
Initial_HHMMSS: Restituzione dell'orario in cui l'applicazione è iniziata

Come:

La funzione Initial_HHMMSS restituisce l'orario quando l'applicazione Maintain è stata avviata come stringa di 8 caratteri, con punti incorporati separati da ore, minuti e secondi.

Per usare questa funzione, è necessario importare la funzione libreria MNTUWS. Per dettagli sull'importazione di questa libreria, consultare Chiamata di una funzione.
x
Sintassi: Come recuperare l’ora iniziale
Initial_HHMMSS()
Inizio pagina
x
Initial_TODAY: Restituzione della data in cui l'applicazione è iniziata

Come:

La funzione Initial_TODAY restituisce la data nel formato MM/DD/YY quando l'applicazione Maintain è iniziata come stringa di 8 caratteri con sbarre incorporate.

Per usare questa funzione, è necessario importare la funzione libreria MNTUWS. Per dettagli sull'importazione di questa libreria, consultare Chiamata di una funzione.
x
Sintassi: Come recuperare la data iniziale
Initial_TODAY()
Inizio pagina
x
TODAY: Recupero della data corrente (Maintain)

Come:

La funzione TODAY recupera la data corrente dal sistema nel formato MM/DD/YY. TODAYRerstituisce sempre una data corrente. Quindi, se s sta eseguendo una applicazione la sera tardi, utilizzare TODAY. È possibile rimuovere le sbarre incorporate con la funzione EDIT.

Per usare questa funzione, è necessario importare la funzione libreria MNTUWS. Per informazioni sull'importazione di questa libreria, consultare Chiamata di una funzione.

È presente una versione della funzione TODAY, disponibile solo nel linguaggio di reporting. Per informazioni su questa funzione, consultare HTMTOTS o TIMETOTS: Conversione di un'ora in un indicatore data/ora.
x
Sintassi: Come restituire la data corrente
TODAY()
Esempio: Restituzione della data corrente

TODAY recupera la data corrente dal sistema: 

MAINTAIN
Module Import (mntuws);
 
Case Top
Compute date1/a8 = today();
type "Date1 = <<date1"
Endcase
END

Il risultato è:

Date1 = 07/17/02
Inizio pagina
x
TODAY2: Restituzione della data corrente

Come:

La funzione TODAY recupera la data corrente dal sistema operativo nel formato MM/DD/YYYY. Usare il formato A10 con la funzione TODAY2 per assicurare risultati corretti.

Per usare questa funzione, è necessario importare la funzione libreria MNTUWS. Per informazioni sull'importazione di questa libreria, consultare Chiamata di una funzione.
x
Sintassi: Come restituire la data corrente
TODAY2()
Esempio: Restituzione della data corrente

TODAY2 recupera la data corrente dal sistema:

MAINTAIN
Module Import (mntuws);
 
Case Top
Compute date2/a10 = today2();
type "Date2 = <<date2"
Endcase
END

Il risultato è:

Date2 = 07/17/2002
Inizio pagina
x
ADD: Aggiunta di giorni in una data

Come:

La funzione ADD aggiunge un dato numero di giorni ad una data.

x
Sintassi: Come aggiungere giorni ad una data
ADD(date,value)

oppure 

date.ADD(value)

dove:

data
La data a cui aggiungere giorni, o un campo contenente la data.
valore
Il numero di giorni per cui aumentare la data.

Questa funzione cambia il valore della data.
Esempio: Aggiunta di giorni in una data

ADD aggiunge 10 giorni ad ogni valore nel campo DateVar: 

ADD(DateVar, 10)

I seguenti sono valori campione per Date Var e i valori corrispondenti per ADD (DateVar, 10):

DateVar      ADD(DateVar, 10);
-------      -----------------
12/31/1999   01/10/2000
01/01/2000   01/11/2000
01/02/2000   01/12/2000
Inizio pagina
x
DAY: Estrazione del giorno del mese da una data

Come:

La funzione DAY estrae il giorno del mese da una data e restituisce il risultato come valore intero.

x
Sintassi: Come estrarre il giorno del mese da una data
DAY(date);

dove:

data
La data (in formato data) da cui estrarre il giorno del mese, o il campo contenente la data.
Esempio: Estrazione del giorno del mese da una data

DAY estrae il giorno del mese dal campo DATE: 

DAY(DATE)

I seguenti sono valori campione per DATE e i valori corrispondenti per DAY (DATE):

DATE         DAY(DATE)
----         ---------
01/01/2000   1
01/02/2000   2
01/03/2000   3
Inizio pagina
x
JULIAN: Determinazione di quanti giorni sono trascorsi nell'anno

Come:

La funzione JULIAN determina il numero di giorni trascorsi nel dato anno, fino ad una certa data, e restituisce il risultato come valore intero.

x
Sintassi: Come determinare quanti giorni sono trascorsi nell'anno
JULIAN(date);

dove:

data
La data (in formato data) per cui determinare il numero di giorni trascorsi nel dato anno, o un campo contenente la data.
Esempio: Determinazione di quanti giorni sono trascorsi nell'anno

JULIAN determina il numero di giorni trascorsi fino alla data del campo DATE: 

JULIAN(DATE)

I seguenti sono valori campione per DATE e i valori corrispondenti per JULIAN (DATE):

DATE         JULIAN(DATE)
----         ------------
01/01/2000   1
02/01/2000   32
03/01/2000   61
Inizio pagina
x
MONTH: Estrazione del mese da una data

Come:

La funzione MONTH estrae il mese da una data e restituisce il risultato come valore intero.

x
Sintassi: Come estrarre il mese da una data
MONTH(date);

dove:

data
La data (in formato data) da cui estrarre il mese, o un campo contenente la data.
Esempio: Estrazione del mese da una data

MONTH estrae il mese per ogni valore nel campo DATE: 

MONTH(DATE)

I seguenti sono valori campione per DATE ed i valori corrispondenti per MONTH (DATE):

DATE         MONTH(DATE)
----         -----------
01/01/2000   1
02/01/2000   2
03/01/2000   3
Inizio pagina
x
QUARTER: Determinazione del trimestre

Come:

La funzione QUARTER determina il trimestre dell'anno in cui si trova la data e restituisce il risultato come valore intero.

x
Sintassi: Come determinare il trimestre per una data
QUARTER(date);

dove:

data
La data (in formato data) per cui determinare il trimestre, o un campo contenente la data.
Esempio: Determinazione del trimestre per una data

QUARTER estrae il componente trimestre da ogni valore nel campo DATE: 

QUARTER(DATE)

I seguenti sono valori campione per DATE ed i valori corrispondenti per QUARTER(DATE):

DATE         QUARTER(DATE)
----         -------------
01/01/2000   1
04/01/2000   2
07/01/2000   3
Inizio pagina
x
SETMDY: Impostazione del valore in una data

Come:

La funzione SETMDY imposta un valore in una data a seconda dei valori numerici rappresentanti un giorno, mese e anno. SETMDY restituisce uno 0 se la funzione è corretta e un numero negativo se la funzione è scorretta.

x
Sintassi: Come impostare un valore nella data
SETMDY(date, month, day, year);

oppure 

date.SETMDY(month, day, year);

dove:

data
La data, nel formato data, o un campo contenente la data.
mese
Un valore intero rappresentante un mese.
Giorno
Un valore intero rappresentante il giorno del mese.
anno
Un valore intero rappresentante un anno.
Esempio: Impostazione di un valore nella data

SETMDY imposta il valore di DateVar, il quale è formattato come data che appare come wrMtrDYY (per esempio, Sabato, 1 Gennaio 2000): 

SETMDY(DateVar, month, day, year);

I seguenti sono valori campione per il mese, giorno e anno e le date corrispondenti per DateVar:

month  day   year   DateVar
-----  ---   ----   -------
04     05    1965   Monday, April 5, 1965
02     01    1997   Saturday, February 1, 1997
01     01    2000   Saturday, January 1, 2000
Inizio pagina
x
SUB: Sottrazione di un valore dalla data

Come:

La funzione SUB sottrae un dato numero di giorni dalla data.

x
Sintassi: Come sottrarre un valore dalla data
SUB(date,value)

oppure 

date.SUB(value)

dove:

data
La data per cui sottrarre il valore, o un campo contenente la data.
valore
Il valore da sottrarre dalla data.
Esempio: Sottrazione di giorni dalla data

SUB sottrae 10 giorni da ogni valore nel campo DateVar. 

SUB(DateVar, 10)

I seguenti sono valori campione per DateVar e i valori corrispondenti per SUB (DateVar, 10):

DateVar      SUB(DateVar, 10);
-------      -----------------
12/31/1999   12/21/2000
01/01/2000   12/22/2000
01/02/2000   12/23/2000
Inizio pagina
x
WEEKDAY: Determinazione del giorno della settimana per una data

Come:

La funzione WEEKDAY determina il giorno della settimana per la data e restituisce il risultato come valore intero (1=Lunedì, 2=Martedì e così via).

x
Sintassi: Come determinare il giorno della settimana per la data
WEEKDAY(date);

dove:

data
La data (in formato data) per cui determinare il giorno della settimana, o il campo contenente la data.
Esempio: Determinazione del giorno della settimana per la data

WEEKDAY determina il giorno della settimana per ogni data nel campo DATE e memorizza quel giorno come numero corrispondente ad un giorno della settimana: 

WEEKDAY(DATE)

I seguenti sono valori campione per DATE e i valori corrispondenti per WEEKDAY(DATE):

DATE         WEEKDAY(DATE)
----         -------------
01/01/2000   6
01/02/2000   7
01/03/2000   1
Inizio pagina
x
YEAR: Estrazione dell'anno dalla data

Come:

La funzione YEAR estrae l'anno dalla data.

x
Sintassi: Come estrarre l'anno dalla data
YEAR(date);

dove:

data
La data da cui estrarre l'anno, o il campo contenente la data.
Esempio: Estrazione di un anno da una data

YEAR estrae l'anno dal campo DATE e memorizza quell'anno nel campo YEAR(DATE): 

YEAR(DATE)

I seguenti sono valori campione per DATE e i valori corrispondenti per YEAR (DATE):

DATE          YEAR(DATE)
----          ----------
01/01/2000    2000
02/01/2001    2001
03/01/2002    2002
WebFOCUS