|
|
|
|
|
Classe BirtDateTime
La classe BirtDateTime fornisce funzioni che consentono di determinare l'intervallo di tempo tra due date o orari, di aggiungere o sottrarre intervalli di tempo e di richiamare parti di una data. Dal momento che gli intervalli di tempo sono solo numeri, l'applicazione può utilizzare la semplice matematica su di essi: moltiplicazione, divisione, addizione, sottrazione e così via. Questa classe è statica. L'applicazione non può creare istanze della classe.
BirtDateTime.addDay
Questa funzione restituisce una nuova data che è il risultato dell'operazione di aggiunta di un dato numero di giorni ad una data. Il numero di giorni da aggiungere può essere negativo. In questo caso si otterrà lo stesso risultato ottenuto se tale numero fosse stato sottratto dalla data.
Un oggetto data che rappresenta la data di inizio.
Il numero di giorni da aggiungere alla data.
Una data che è il risultato dell'aggiunta del numero specificato di giorni alla data di inizio.
Il seguente esempio aggiunge giorni ad una data specificata:
Il seguente esempio aggiunge 15 giorni ad ogni valore di data nel campo InvoiceDate:
BirtDateTime.addHour
Questa funzione restituisce una nuova data che è il risultato dell'aggiunta di un dato numero di ore ad una data. Il numero di ore da aggiungere può essere negativo. In questo caso si otterrà lo stesso risultato ottenuto se tale numero fosse stato sottratto dalla data.
Un oggetto data che rappresenta la data di inizio. Se una data di inizio non ha un valore dell'ora, la funzione presuppone che l'ora sia mezzanotte (00:00:00).
Il numero di ore da aggiungere alla data.
Una data che è il risultato dell'aggiunta del numero specificato di ore alla data di inizio.
Il seguente esempio aggiunge ore ad una data ed ora specifiche:
Il seguente esempio aggiunge 36 ore ad ogni valore di data nel campo StartTime:
BirtDateTime.addMinute
Questa funzione restituisce una nuova data che è il risultato dell'aggiunta di un dato numero di minuti ad una data. Il numero di minuti da aggiungere può essere negativo. In questo caso si otterrà lo stesso risultato ottenuto se tale numero fosse stato sottratto dalla data.
Un oggetto data che rappresenta la data di inizio. Se una data di inizio non ha un valore dell'ora, la funzione presuppone che l'ora sia mezzanotte (00:00:00).
Il numero di minuti da aggiungere alla data.
Una data che è il risultato dell'aggiunta del numero specificato di minuti alla data di inizio.
Il seguente esempio aggiunge minuti ad una data e ora specifiche:
Il seguente esempio aggiunge 15 minuti ad ogni valore di data nel campo StartTime:
BirtDateTime.addMonth
Questa funzione restituisce una nuova data che è il risultato dell'aggiunta di un dato numero di mesi ad una data. Il numero di mesi da aggiungere può essere negativo. In questo caso si otterrà lo stesso risultato ottenuto se tale numero fosse stato sottratto dalla data.
Questa funzione restituisce sempre una data valida. Se necessario, la parte giorno della data risultante viene regolata andando all'ultimo giorno del mese e dell'anno risultanti. Ad esempio, se si aggiunge 1 mese a Gen 31, 2008, addMonth( ) restituisce Feb 29, 2008 (2008 è un anno bisestile), non Feb 31, 2008.
Un oggetto data che rappresenta la data di inizio.
Il numero di mesi da aggiungere alla data.
Una data che è il risultato dell'aggiunta del numero specificato di mesi alla data di inizio.
Il seguente esempio aggiunge mesi ad una data specificata:
Il seguente esempio aggiunge 10 mesi ad ogni valore di data nel campo InvoiceDate:
BirtDateTime.addQuarter
Questa funzione restituisce una nuova data che è il risultato dell'aggiunta di un dato numero di trimestri ad una data. Un trimestre corrisponde a tre mesi. Ad esempio, se si aggiungono 2 trimestri a 10 Set 2008, la funzione restituisce 10 Mar 2009. Il numero di trimestri da aggiungere può essere negativo. In questo caso si otterrà lo stesso risultato ottenuto se tale numero fosse stato sottratto dalla data.
Un oggetto data che rappresenta la data di inizio.
Il numero di trimestri da aggiungere alla data.
Una data che è il risultato dell'aggiunta del numero specificato di trimestri alla data di inizio.
Il seguente esempio aggiunge trimestri ad una specifica data:
var startDate = "2008-12-15";var endDate;Il seguente esempio aggiunge 2 trimestri ad ogni valore di data nel campo ForecastClosing:
BirtDateTime.addSecond
Questa funzione restituisce una nuova data che è il risultato dell'aggiunta di un dato numero di secondi ad una data. Il numero di secondi da aggiungere può essere negativo. In questo caso si otterrà lo stesso risultato ottenuto se tale numero fosse stato sottratto dalla data.
Un oggetto data che rappresenta la data di inizio. Se una data di inizio non ha un valore dell'ora, la funzione presuppone che l'ora sia mezzanotte (00:00:00).
Il numero di secondi da aggiungere alla data.
Una data che è il risultato dell'aggiunta del numero specificato di secondi alla data di inizio.
Il seguente esempio aggiunge secondi ad una data ed ora specifiche:
var startDate = "2008-12-31 10:30:00";Il seguente esempio aggiunge 6000 secondi ad ogni valore di data nel campo StartTime:
BirtDateTime.addWeek
Questa funzione restituisce una nuova data che è il risultato dell'aggiunta di un dato numero di settimane ad una data. Il numero di settimane da aggiungere può essere negativo. In questo caso si otterrà lo stesso risultato ottenuto se tale numero fosse stato sottratto dalla data.
Un oggetto data che rappresenta la data di inizio.
Il numero di settimane da aggiungere alla data.
Una data che è il risultato dell'aggiunta del numero specificato di settimane alla data di inizio.
Il seguente esempio aggiunge settimane ad una data specificata:
endDate = BirtDateTime.addWeek( startDate, 1 ); // restituisce Gen 07, 2009endDate = BirtDateTime.addWeek( startDate, -1 ); // restituisce Dic 24, 2008Il seguente esempio aggiunge 2 settimane ad ogni valore di data nel campo InvoiceDate:
BirtDateTime.addYear
Questa funzione restituisce una nuova data che è il risultato dell'aggiunta di un dato numero di anni ad una data. Il numero di anni da aggiungere può essere negativo. In questo caso si otterrà lo stesso risultato ottenuto se tale numero fosse stato sottratto dalla data.
Un oggetto data che rappresenta la data di inizio.
Il numero di anni da aggiungere alla data.
Una data che è il risultato dell'aggiunta del numero specificato di anni alla data di inizio.
Il seguente esempio aggiunge anni ad una specifica data:
Il seguente esempio aggiunge 5 anni ad ogni valore di data nel campo HireDate:
BirtDateTime.day
Questa funzione restituisce un numero che va da 1 a 31 che rappresenta il giorno del mese per una determinata data. Ad esempio, se la data è 2009-01-19, la funzione restituisce 19.
Un oggetto data da cui ottenere il giorno.
Un numero che rappresenta il giorno del mese di una determinata data.
Il seguente esempio restituisce il giorno del mese di ogni valore nel campo ShipDate:
Il seguente esempio restituisce il giorno del mese della data corrente:
BirtDateTime.diffDay
Questa funzione restituisce il numero di giorni compresi fra due date. Un giorno viene calcolato sottraendo il valore del giorno della prima data dal valore del giorno della seconda data. Ad esempio, se la prima data è 2008-12-30 23:59:59 e la seconda data è 2008-12-31 00:00:00, la funzione restituisce 1 giorno, anche se un solo secondo separa le due date.
Un oggetto data che rappresenta l'inizio dell'intervallo di tempo.
Un oggetto data che rappresenta la fine dell'intervallo di tempo.
Il numero di giorni fra le due date.
Il seguente esempio restituisce il numero di giorni fra date specifiche:
Il seguente esempio restituisce il numero di giorni compreso fra la data corrente e la fine del 2009:
Il seguente esempio restituisce il numero di giorni tra i valori nei campi InvoiceDate e PaymentDate:
BirtDateTime.diffHour
Questa funzione restituisce il numero di ore comprese fra due date. Un'ora viene calcolata sottraendo il valore dell'ora della prima data dal valore dell'ora della seconda data. Ad esempio, se la prima data è 2009-01-31 1:30:00 e la seconda 2009-01-31 2:00:00, la funzione restituisce 1 ora, anche se solo 30 minuti separano le due date. Se una data non ha un valore dell'ora, la funzione presuppone che l'ora sia mezzanotte (00:00:00).
Un oggetto data che rappresenta l'inizio dell'intervallo di tempo.
Un oggetto data che rappresenta la fine dell'intervallo di tempo.
Il numero di ore fra due date.
Il seguente esempio restituisce il numero di ore fra date specifiche:
Il seguente esempio restituisce il numero di ore tra i valori nei campi StartTime e FinishTime:
BirtDateTime.diffMinute
Questa funzione restituisce il numero di minuti compresi fra due date. Un minuto viene calcolato sottraendo il valore del minuto della prima data dal valore del minuto della seconda data. Ad esempio, se la prima data è 2009-01-31 1:30:59 e la seconda data è 2009-01-31 1:31:00, la funzione restituisce 1 minuto, anche se un solo secondo separa le due date. Se una data non ha un valore dell'ora, la funzione presuppone che l'ora sia mezzanotte (00:00:00).
Un oggetto data che rappresenta l'inizio dell'intervallo di tempo.
Un oggetto data che rappresenta la fine dell'intervallo di tempo.
Il numero di minuti fra due date.
Il seguente esempio restituisce il numero di minuti fra date specifiche:
Il seguente esempio restituisce il numero di minuti tra i valori nei campi StartTime e FinishTime:
BirtDateTime.diffMonth
Questa funzione restituisce il numero di mesi tra due date. Un mese viene calcolato sottraendo il valore del mese della prima data dal valore del mese della seconda data. Ad esempio, se la prima data è 2009-01-31 e la seconda data è 2009-02-01, la funzione restituisce 1 mese, anche se un solo giorno separa le due date.
Un oggetto data che rappresenta l'inizio dell'intervallo di tempo.
Un oggetto data che rappresenta la fine dell'intervallo di tempo.
Il numero di mesi fra due date.
Il seguente esempio restituisce il numero di mesi fra date specifiche:
Il seguente esempio restituisce il numero di mesi compreso fra la data corrente e l'inizio del 2010:
Il seguente esempio restituisce il numero di mesi tra i valori nei campi ProjectStart e ProjectComplete:
BirtDateTime.diffQuarter
Questa funzione restituisce il numero di trimestri compresi fra due date. Un trimestre viene calcolato sottraendo il valore del mese della prima data dal valore del mese della seconda data. Una differenza di 3 mesi è uguale a 1 trimestre. Ad esempio, se la prima data è 2009-01-31 e la seconda data è 2009-07-01, la funzione restituisce 2. Se la prima data è 2009-09-30, la funzione restituisce ancora 2
Un oggetto data che rappresenta l'inizio dell'intervallo di tempo.
Un oggetto data che rappresenta la fine dell'intervallo di tempo.
Il numero di trimestri fra due date.
Il seguente esempio restituisce il numero di trimestri fra date specifiche:
Il seguente esempio restituisce il numero di trimestri compreso fra la data corrente e l'inizio del 2010:
Il seguente esempio restituisce il numero di trimestri tra i valori nei campi ProjectStart e ProjectComplete:
BirtDateTime.diffSecond
Questa funzione restituisce il numero di secondi compresi fra due date. Se una data non ha un valore dell'ora, la funzione presuppone che l'ora sia mezzanotte (00:00:00).
Un oggetto data che rappresenta l'inizio dell'intervallo di tempo.
Un oggetto data che rappresenta la fine dell'intervallo di tempo.
Il numero di secondi fra due date.
Il seguente esempio restituisce il numero di secondi fra date specifiche:
Il seguente esempio restituisce il numero di secondi tra i valori nei campi StartTime e FinishTime:
BirtDateTime.diffWeek
Questa funzione restituisce il numero di settimane comprese fra due date. Una settimana viene calcolata sottraendo il numero di settimane della prima data dal numero di settimane della seconda data. Ad esempio, se la prima data è 2009-01-02 (settimana 1 dell'anno) e la seconda data è 2009-01-05 (settimana 2 dell'anno), la funzione restituisce 1 settimana, anche se solo tre giorni separano le due date.
Un oggetto data che rappresenta l'inizio dell'intervallo di tempo.
Un oggetto data che rappresenta la fine dell'intervallo di tempo.
Il numero di settimane fra due date.
Il seguente esempio restituisce il numero di settimane fra date specifiche:
Il seguente esempio restituisce il numero di settimane compreso fra la data corrente e l'inizio del 2010:
Il seguente esempio restituisce il numero di settimane tra i valori nei campi ProjectStart e ProjectComplete:
BirtDateTime.diffYear
Questa funzione restituisce il numero di anni compreso fra due date. Un anno viene calcolato sottraendo il valore dell'anno della prima data dal valore dell'anno della seconda data. Ad esempio, se la prima data è 2009-01-01 e la seconda data è 2009-12-31, la funzione restituisce 0. Se la prima data è 2009-11-15 e la seconda data è 2009-01.15, la funzione restituisce 1.
Un oggetto data che rappresenta l'inizio dell'intervallo di tempo.
Un oggetto data che rappresenta la fine dell'intervallo di tempo.
Il numero di anni fra due date.
Il seguente esempio restituisce il numero di anni fra date specifiche:
Il seguente esempio restituisce il numero di anni tra ciascun valore del campo HireDate e la data corrente:
BirtDateTime.month
Questa funzione restituisce il mese per una determinata data. A seconda dell'opzione specificata, la funzione restituisce il mese come numero, il nome completo del mese o il nome abbreviato del mese. Il nome del mese è specifico delle impostazioni internazionali.
Un oggetto data da cui ottenere il mese.
Se si omette questo argomento, la funzione restituisce il mese sotto forma di numero.
Il mese di una determinata data.
Il seguente esempio mostra i valori dei mesi restituiti per una specifica data:
Il seguente esempio restituisce il mese della data corrente:
BirtDateTime.now
Questa funzione restituisce la data e l'ora correnti, ad esempio, Feb 2, 2009 2:05 PM.
Il seguente esempio restituisce il numero di ore compreso fra la data corrente e il tempo che manca a Natale:
BirtDateTime.diffHour( BirtDateTime.now(), "2009-12-25" )BirtDateTime.quarter
Questa funzione restituisce un numero che va da 1 a 4 che rappresenta il trimestre in cui cade una determinata data. Il primo trimestre inizia a Gennaio 1.
Un oggetto data da cui ottenere il numero del trimestre.
Il numero di trimestre di una determinata data.
Il seguente esempio mostra i numeri dei trimestri restituiti per una specifica data:
Il seguente esempio restituisce il numero di trimestre di ogni valore nel campo CloseDate:
Il seguente esempio restituisce il numero di trimestre della data corrente:
BirtDateTime.today
Questa funzione restituisce la data corrente che include un valore di ora di mezzanotte, ad esempio, Feb 2, 2009 12:00 AM.
La data corrente con valore di ora di mezzanotte.
Il seguente esempio restituisce il numero di giorni che vanno dalla data corrente a Natale:
Il seguente esempio calcola il numero di anni da ogni valore del campo dati HireDate alla data corrente.
BirtDateTime.diffYear( [HireDate], BirtDateTime.today() )BirtDateTime.week
Questa funzione restituisce un numero che va da 1 a 52 che rappresenta il numero settimana per una determinata data.
Un oggetto data da cui ottenere il numero settimana.
Il numero settimana di una determinata data.
Il seguente esempio mostra i numeri settimana restituiti per date specifiche:
Il seguente esempio restituisce il numero settimana di ogni valore nel campo CloseDate:
Il seguente esempio restituisce il numero settimana della data corrente:
BirtDateTime.weekDay
Questa funzione restituisce il giorno della settimana per una determinata data. A seconda dell'opzione specificata, la funzione restituisce il giorno della settimana come numero, il nome completo del giorno della settimana o il nome abbreviato del giorno della settimana. Il nome del giorno della settimana è specifico per la locale.
Un oggetto data da cui ottenere il giorno della settimana.
Facoltativo. Un numero che rappresenta il formato da restituire. Utilizzare uno dei seguenti valori:
Se si omette questo argomento, la funzione presuppone l'opzione 1.
Il giorno della settimana per una determinata data.
Il seguente esempio mostra i valori dei giorni della settimana restituiti per una specifica data:
Il seguente esempio restituisce il giorno della settimana per la data corrente:
BirtDateTime.year
Questa funzione restituisce il valore dell'anno a quattro cifre per una determinata data. Ad esempio, se la data è 2009-01-19, la funzione restituisce 2009.
Un oggetto data da cui ottenere l'anno.
Il valore dell'anno a quattro cifre per una determinata data.
Il seguente esempio restituisce l'anno per ogni valore nel campo HireDate:
| (c) Copyright Actuate Corporation 2009 |