monthend - funzione dello script e del grafico

Questa funzione restituisce un valore corrispondente a un indicatore temporale recante l'ultimo millisecondo dell'ultimo giorno del mese contenente date. Il formato di output predefinito sarà il formato DateFormat impostato nello script.

Sintassi:

MonthEnd(date[, period_no])

In altre parole, la funzione monthend() determina in quale mese cade la data. Quindi, restituisce un timestamp, nel formato data, per l'ultimo millisecondo di quel mese.

Schema che mostra come la funzione monthend possa essere utilizzata per identificare il timestamp più recente di un mese scelto. — Schema della funzione monthend.

Casi di utilizzo

La funzione monthend() viene utilizzata come parte di un'espressione quando si desidera che il calcolo utilizzi la frazione del mese non ancora trascorsa. Ad esempio, se si vuole calcolare l'interesse totale non ancora maturato durante il mese.

Tipo di dati restituiti: duale

Argomenti
Argomento	Descrizione
date	La data o la data e ora da valutare.
period_no	period_no è un numero intero che, se corrisponde a 0 o viene omesso, indica il mese contenente date. I valori negativi di period_no indicano i mesi precedenti, mentre i valori positivi indicano i mesi successivi.

Impostazioni locali

Se non diversamente specificato, gli esempi di questo argomento utilizzano il seguente formato di data: MM/GG/AAAA. Il formato della data viene specificato nell'istruzione SET DateFormat nello script di caricamento dei dati. La formattazione predefinita della data potrebbe essere diversa nel proprio sistema, a causa delle impostazioni regionali e di altri fattori. È possibile modificare i formati degli esempi seguenti in base alle proprie esigenze. In alternativa, è possibile modificare i formati nel proprio script di caricamento per adattarli a questi esempi. Per ulteriori informazioni, vedere Modifica delle impostazioni internazionali per la creazione di app e script.

Le impostazioni regionali predefinite nelle app si basano sul profilo utente. Queste impostazioni di formato regionale non riguardano la lingua visualizzata nell'interfaccia utente Qlik Cloud. Qlik Cloud verrà visualizzato nella stessa lingua del browser utilizzato.

Se si è un creatore di app, è possibile impostare la regione predefinita per le app che si creano. Per ulteriori informazioni, vedere Regolazione delle impostazioni internazionali preferite per la creazione di app e script in Qlik Cloud Analytics.

Esempi di funzioni
Esempio	Risultato
monthend('02/19/2012')	Restituisce 02/29/2012 23:59:59.
monthend('02/19/2001', -1)	Restituisce 01/31/2001 23:59:59.

Esempio 1 – Esempio di base

Panoramica

Aprire l'editor caricamento dati e aggiungere lo script di caricamento sotto in una nuova scheda.

Lo script di caricamento contiene:

Un set di dati contenente un insieme di transazioni per il 2022 viene caricato in una tabella denominata 'Transactions'.
Un campo data nel formato DateFormat della variabile di sistema (MM/DD/YYYY).
Un'istruzione di caricamento precedente contenente:
- La funzione monthend() impostata come campo, ‘end_of_month’.
- La funzione timestamp impostata come campo, ‘end_of_month_timestamp’.

Script di caricamento

SET DateFormat='MM/DD/YYYY'; 

Transactions: 
    Load 
    *, 
    monthend(date) as end_of_month, 
    timestamp(monthend(date)) as end_of_month_timestamp 
    ; 
Load 
* 
Inline  
[ 
id,date,amount 
8188,1/7/2022,17.17 
8189,1/19/2022,37.23 
8190,2/28/2022,88.27 
8191,2/5/2022,57.42 
8192,3/16/2022,53.80 
8193,4/1/2022,82.06 
8194,5/7/2022,40.39 
8195,5/16/2022,87.21 
8196,6/15/2022,95.93 
8197,6/26/2022,45.89 
8198,7/9/2022,36.23 
8199,7/22/2022,25.66 
8200,7/23/2022,82.77 
8201,7/27/2022,69.98 
8202,8/2/2022,76.11 
8203,8/8/2022,25.12 
8204,8/19/2022,46.23 
8205,9/26/2022,84.21 
8206,10/14/2022,96.24 
8207,10/29/2022,67.67 
];

Risultati

Caricare i dati e aprire un foglio. Creare una nuova tabella e aggiungere tali campi come dimensioni:

id
date
end_of_month
end_of_month_timestamp

Tabella dei risultati
id	date	end_of_month	end_of_month_timestamp
8188	1/7/2022	01/31/2022	1/31/2022 11:59:59 PM
8189	1/19/2022	01/31/2022	1/31/2022 11:59:59 PM
8190	2/5/2022	02/28/2022	2/28/2022 11:59:59 PM
8191	2/28/2022	02/28/2022	2/28/2022 11:59:59 PM
8192	3/16/2022	03/31/2022	3/31/2022 11:59:59 PM
8193	4/1/2022	04/30/2022	4/30/2022 11:59:59 PM
8194	5/7/2022	05/31/2022	5/31/2022 11:59:59 PM
8195	5/16/2022	05/31/2022	5/31/2022 11:59:59 PM
8196	6/15/2022	06/30/2022	6/30/2022 11:59:59 PM
8197	6/26/2022	06/30/2022	6/30/2022 11:59:59 PM
8198	7/9/2022	07/31/2022	7/31/2022 11:59:59 PM
8199	7/22/2022	07/31/2022	7/31/2022 11:59:59 PM
8200	7/23/2022	07/31/2022	7/31/2022 11:59:59 PM
8201	7/27/2022	07/31/2022	7/31/2022 11:59:59 PM
8202	8/2/2022	08/31/2022	8/31/2022 11:59:59 PM
8203	8/8/2022	08/31/2022	8/31/2022 11:59:59 PM
8204	8/19/2022	08/31/2022	8/31/2022 11:59:59 PM
8205	9/26/2022	09/30/2022	9/30/2022 11:59:59 PM
8206	10/14/2022	10/31/2022	10/31/2022 11:59:59 PM
8207	10/29/2022	10/31/2022	10/31/2022 11:59:59 PM

Il campo 'end_of_month' viene creato nell'istruzione di caricamento precedente mediante l'uso della funzione monthend() e trasferendo il campo data come argomento della funzione.

La funzione monthend() identifica in quale mese cade il valore della data, restituendo un timestamp per l'ultimo millisecondo di quel mese.

La transazione 8192 è avvenuta il 16 marzo. La funzione monthend() restituisce l'ultimo millisecondo di quel mese, ovvero il 31 marzo alle 23:59:59.

Esempio 2 – period_no

Panoramica

Vengono utilizzati lo stesso set di dati e lo stesso scenario del primo esempio.

In questo esempio, si tratta di creare un campo, 'previous_month_end', che restituisca il timestamp della fine del mese precedente la transazione.

Script di caricamento

SET DateFormat='MM/DD/YYYY'; 
						
Transactions: 
    Load 
    *, 
    monthend(date,-1) as previous_month_end, 
    timestamp(monthend(date,-1)) as previous_month_end_timestamp 
    ; 
Load 
* 
Inline  
[ 
id,date,amount 
8188,1/7/2022,17.17 
8189,1/19/2022,37.23 
8190,2/28/2022,88.27 
8191,2/5/2022,57.42 
8192,3/16/2022,53.80 
8193,4/1/2022,82.06 
8194,5/7/2022,40.39 
8195,5/16/2022,87.21 
8196,6/15/2022,95.93 
8197,6/26/2022,45.89 
8198,7/9/2022,36.23 
8199,7/22/2022,25.66 
8200,7/23/2022,82.77
8201,7/27/2022,69.98 
8202,8/2/2022,76.11 
8203,8/8/2022,25.12 
8204,8/19/2022,46.23 
8205,9/26/2022,84.21 
8206,10/14/2022,96.24 
8207,10/29/2022,67.67 
];

Risultati

Caricare i dati e aprire un foglio. Creare una nuova tabella e aggiungere tali campi come dimensioni:

id
date
previous_month_end
previous_month_end_timestamp

Tabella dei risultati
id	date	previous_month_end	previous_month_end_timestamp
8188	1/7/2022	12/31/2021	12/31/2021 11:59:59 PM
8189	1/19/2022	12/31/2021	12/31/2021 11:59:59 PM
8190	2/5/2022	01/31/2022	1/31/2022 11:59:59 PM
8191	2/28/2022	01/31/2022	1/31/2022 11:59:59 PM
8192	3/16/2022	02/28/2022	2/28/2022 11:59:59 PM
8193	4/1/2022	03/31/2022	3/31/2022 11:59:59 PM
8194	5/7/2022	04/30/2022	4/30/2022 11:59:59 PM
8195	5/16/2022	04/30/2022	4/30/2022 11:59:59 PM
8196	6/15/2022	05/31/2022	5/31/2022 11:59:59 PM
8197	6/26/2022	05/31/2022	5/31/2022 11:59:59 PM
8198	7/9/2022	06/30/2022	6/30/2022 11:59:59 PM
8199	7/22/2022	06/30/2022	6/30/2022 11:59:59 PM
8200	7/23/2022	06/30/2022	6/30/2022 11:59:59 PM
8201	7/27/2022	06/30/2022	6/30/2022 11:59:59 PM
8202	8/2/2022	07/31/2022	7/31/2022 11:59:59 PM
8203	8/8/2022	07/31/2022	7/31/2022 11:59:59 PM
8204	8/19/2022	07/31/2022	7/31/2022 11:59:59 PM
8205	9/26/2022	08/31/2022	8/31/2022 11:59:59 PM
8206	10/14/2022	09/30/2022	9/30/2022 11:59:59 PM
8207	10/29/2022	09/30/2022	9/30/2022 11:59:59 PM

La funzione monthend() identifica innanzitutto il mese in cui avvengono le transazioni, in quanto un valore period_no di -1 viene utilizzato come argomento di offset. Si sposta poi un mese prima e identifica il millisecondo finale di tale mese.

Schema che mostra come la funzione monthend possa essere utilizzata con la variabile period_no per identificare l'ultimo timestamp del mese precedente a quello impostato nella funzione monthend(). — Schema della funzione monthend con la variabile period_no.

La transazione 8192 è avvenuta il 16 marzo. La funzione monthend() identifica che il mese precedente la transazione è avvenuta in febbraio. Quindi restituisce l'ultimo millisecondo di quel mese, il 28 febbraio alle 23:59:59.

Esempio 3 – Esempio di grafico

Panoramica

Vengono utilizzati lo stesso set di dati e lo stesso scenario del primo esempio.

In questo esempio, il set di dati è invariato e viene caricato nell'app. Per questa attività, è necessario creare un calcolo che restituisce data e ora per la fine del mese in cui sono avvenute le transazioni come misura in un grafico dell'app.

Script di caricamento

Transactions: 
Load 
* 
Inline  
[ 
id,date,amount 
8188,1/7/2022,17.17 
8189,1/19/2022,37.23 
8190,2/28/2022,88.27 
8191,2/5/2022,57.42 
8192,3/16/2022,53.80 
8193,4/1/2022,82.06 
8194,5/7/2022,40.39 
8195,5/16/2022,87.21 
8196,6/15/2022,95.93 
8197,6/26/2022,45.89 
8198,7/9/2022,36.23 
8199,7/22/2022,25.66 
8200,7/23/2022,82.77 
8201,7/27/2022,69.98 
8202,8/2/2022,76.11 
8203,8/8/2022,25.12 
8204,8/19/2022,46.23 
8205,9/26/2022,84.21 
8206,10/14/2022,96.24 
8207,10/29/2022,67.67 
];

Risultati

Caricare i dati e aprire un foglio. Creare una nuova tabella e aggiungere tali campi come dimensioni:

date
id

Per calcolare la data di fine del mese in cui avviene una transazione, creare le seguenti misure:

=monthend(date)
=timestamp(monthend(date))

Tabella dei risultati
id	date	=monthend(date)	=timestamp(monthend(date))
8188	10/14/2022	10/31/2022	10/31/2022 11:59:59 PM
8189	10/29/2022	10/31/2022	10/31/2022 11:59:59 PM
8190	9/26/2022	09/30/2022	9/30/2022 11:59:59 PM
8191	8/2/2022	08/31/2022	8/31/2022 11:59:59 PM
8192	8/8/2022	08/31/2022	8/31/2022 11:59:59 PM
8193	8/19/2022	08/31/2022	8/31/2022 11:59:59 PM
8194	7/9/2022	07/31/2022	7/31/2022 11:59:59 PM
8195	7/22/2022	07/31/2022	7/31/2022 11:59:59 PM
8196	7/23/2022	07/31/2022	7/31/2022 11:59:59 PM
8197	7/27/2022	07/31/2022	7/31/2022 11:59:59 PM
8198	6/15/2022	06/30/2022	6/30/2022 11:59:59 PM
8199	6/26/2022	06/30/2022	6/30/2022 11:59:59 PM
8200	5/7/2022	05/31/2022	5/31/2022 11:59:59 PM
8201	5/16/2022	05/31/2022	5/31/2022 11:59:59 PM
8202	4/1/2022	04/30/2022	4/30/2022 11:59:59 PM
8203	3/16/2022	03/31/2022	3/31/2022 11:59:59 PM
8204	2/5/2022	02/28/2022	2/28/2022 11:59:59 PM
8205	2/28/2022	02/28/2022	2/28/2022 11:59:59 PM
8206	1/7/2022	01/31/2022	1/31/2022 11:59:59 PM
8207	1/19/2022	01/31/2022	1/31/2022 11:59:59 PM

La misura 'end_of_month' viene creata nel grafico mediante l'utilizzo della funzione monthend() e trasferendo il campo data come argomento della funzione.

La funzione monthend() identifica in quale mese cade il valore della data, restituendo un timestamp per l'ultimo millisecondo di quel mese.

Fare clic per visualizzare a dimensioni complete — Schema della funzione monthend con la variabile period_no.

La transazione 8192 è avvenuta il 16 marzo. La funzione monthend() restituisce l'ultimo millisecondo di quel mese, ovvero il 31 marzo alle 23:59:59.

Esempio 4 – Scenario

Panoramica

In questo esempio, un set di dati è caricato in una tabella denominata "Employee_Expenses". La tabella contiene i seguenti campi:

ID dipendenti
Nomi dipendenti
La media delle richieste di rimborso spese giornaliero di ciascun dipendente.

L'utente finale desidera un grafico che visualizzi, in base all'id e al nome del dipendente, la spesa stimata per il resto del mese.

Script di caricamento

Employee_Expenses: 
Load 
* 
Inline  
[ 
employee_id,employee_name,avg_daily_claim 
182,Mark, $15 
183,Deryck, $12.5  
184,Dexter, $12.5 
185,Sydney,$27 
186,Agatha,$18 
];

Risultati

Caricare i dati e aprire un foglio. Creare una nuova tabella e aggiungere tali campi come dimensioni:

employee_id
employee_name

Per calcolare gli interessi accumulati, creare questa misura:

=floor(monthend(today(1),0)-today(1))*avg_daily_claim

Questa misura è dinamica e produrrà risultati diversi a seconda della data di caricamento dei dati.

Impostare la misura Formattazione numero su Denaro.

Tabella dei risultati
employee_id	employee_name	=floor(monthend(today(1),0)-today(1))*avg_daily_claim
182	Contrassegno	$30.00
183	Deryck	$25.00
184	Dexter	$25.00
185	Sydney	$54.00
186	Agatha	$36.00

La funzione monthend() restituisce la data di fine del mese corrente utilizzando come unico argomento la data odierna. L'espressione restituisce il numero di giorni rimanenti nel mese sottraendo la data odierna dalla data di fine mese.

Questo valore viene quindi moltiplicato per la media delle richieste di rimborso spese giornaliere di ciascun dipendente per calcolare il valore stimato delle richieste che ogni dipendente dovrebbe presentare durante il periodo rimanente del mese.

Hai trovato utile questa pagina?

Se riscontri problemi con questa pagina o con il suo contenuto – un errore di battitura, un passaggio mancante o un errore tecnico – facci sapere come possiamo migliorare!

Lascia qui il tuo feedback