La categoria My.DateTime contiene tutte le funzioni built-in disponibili in Overbasic per l’accesso alle date.
DateAdd #
Aggiunge un intervallo di tempo (espresso in Millisecondi, Secondi, Minuti, Ore, Giorni, Mesi, Anni), ad una data/ora.
Tipo di risultato: un numero intero rappresentante una data o un ora
Argomenti:
- DATE: un numero intero rappresentante una data nel formato YYYYMMDD (dove YYYY = anno; MM = mese; DD = giorno)
- TIME: un numero intero rappresentante un orario nel formato HHMMSSFFFCCCN (dove HH = ora; MM = minuti; SS = secondi; FFF = millisecondi; CCC = microsecondi; N = nanosecondi (centinaia)
- INTERVAL: intervallo di tempo da sommare:
- F: millisecondi
- S: secondi
- MIN: minuti
- H: ore
- D: giorni
- M: mesi
- Y: anni
- NUMBER OF INTERVALS: numero di intervalli di tempo da sommare/sottrarre a DATE/TIME. Se maggiore di zero, gli intervalli saranno sommati a DATE/TIME, se minore di zero saranno sottratti.
- VALUE TO RETURN:
- D: la funzione restituisce una data nel formato YYYYMMDD
- T: la funzione restituisce un orario nel formato HHMMSSFFFCCCN
Esempi:
Dim t As Numeric = My.DateTime.DateAdd(20220101, 1200000000000, "MIN", 5, "T")
'Risultato: 1205000000000
Dim t As Numeric = My.DateTime.DateAdd(20220101, 1200000000000, "MIN", -5, "T")
'Risultato: 1155000000000
Day #
Restituisce il Giorno della barra corrente o della barra ottenuta sommando l’argomento OFFSET alla barra corrente.
Tipo di risultato: un numero intero rappresentante il giorno nel formato DD
Argomenti:
- OFFSET: (facoltativo) differenza (in numero di barre) tra la barra corrente e la barra contenente il dato da ottenere. Per esempio, per ottenere il dato di 2 barre precedenti la barra corrente, impostare l’OFFSET uguale a -2.
'La seguente riga di codice restituisce il giorno della barra corrente:
Dim d As Numeric = My.DateTime.Day
'Risultato: se la data della barra corrente è 20230315, il risultato sarà 15
'La seguente riga di codice restituisce il giorno di 2 barre indietro:
Dim d As Numeric = My.DateTime.Day(-2)
DayOfWeek #
Restituisce il numero del giorno della settimana della barra corrente o della barra ottenuta sommando l’argomento OFFSET alla barra corrente.
Tipo di risultato: un numero intero (da 1 a 7) rappresentante il giorno della settimana:
- 1 = Domenica
- 2 = Lunedì
- 3 = Martedì
- 4 = Mercoledì
- 5 = Giovedì
- 6 = Venerdì
- 7 = Sabato
Argomenti:
- OFFSET: (facoltativo) differenza (in numero di barre) tra la barra corrente e la barra contenente il dato da ottenere. Per esempio, per ottenere il dato di 2 barre precedenti la barra corrente, impostare l’OFFSET uguale a -2.
'La seguente riga di codice restituisce il numero del giorno della settimana della barra corrente:
Dim dw As Numeric = My.DateTime.DayOfWeek
'La seguente riga di codice restituisce il numero del giorno della settimana di 2 barre indietro:
Dim dw As Numeric = My.DateTime.DayOfWeek(-2)
Hour #
Restituisce l’Ora della barra corrente o della barra ottenuta sommando l’argomento OFFSET alla barra corrente.
Tipo di risultato: un numero intero rappresentante l’Ora nel formato HH
Argomenti:
- OFFSET: (facoltativo) differenza (in numero di barre) tra la barra corrente e la barra contenente il dato da ottenere. Per esempio, per ottenere il dato di 2 barre precedenti la barra corrente, impostare l’OFFSET uguale a -2.
'La seguente riga di codice restituisce l'ora della barra corrente:
Dim h As Numeric = My.DateTime.Hour
'Risultato: se l'ora della barra corrente è 1215345002679, il risultato sarà 12
'La seguente riga di codice restituisce l'ora di 2 barre indietro:
Dim h As Numeric = My.DateTime.Hour(-2)
MicroSecond #
Restituisce i Microsecondi della barra corrente o della barra ottenuta sommando l’argomento OFFSET alla barra corrente.
Tipo di risultato: un numero intero rappresentante i microsecondi nel formato CCC
Argomenti:
- OFFSET: (facoltativo) differenza (in numero di barre) tra la barra corrente e la barra contenente il dato da ottenere. Per esempio, per ottenere il dato di 2 barre precedenti la barra corrente, impostare l’OFFSET uguale a -2.
'La seguente riga di codice restituisce i microsecondi della barra corrente:
Dim c As Numeric = My.DateTime.MicroSecond
'Risultato: se l'ora della barra corrente è 1215345002679, il risultato sarà 267
'La seguente riga di codice restituisce i microsecondi di 2 barre indietro:
Dim c As Numeric = My.DateTime.MicroSecond(-2)
MilliSecond #
Restituisce i Millisecondi della barra corrente o della barra ottenuta sommando l’argomento OFFSET alla barra corrente.
Tipo di risultato: un numero intero rappresentante i millisecondi nel formato FFF
Argomenti:
- OFFSET: (facoltativo) differenza (in numero di barre) tra la barra corrente e la barra contenente il dato da ottenere. Per esempio, per ottenere il dato di 2 barre precedenti la barra corrente, impostare l’OFFSET uguale a -2.
'La seguente riga di codice restituisce i millisecondi della barra corrente:
Dim c As Numeric = My.DateTime.MilliSecond
'Risultato: se l'ora della barra corrente è 1215345002679, il risultato sarà 500
'La seguente riga di codice restituisce i millisecondi di 2 barre indietro:
Dim c As Numeric = My.DateTime.MilliSecond(-2)
Minute #
Restituisce i Minuti della barra corrente o della barra ottenuta sommando l’argomento OFFSET alla barra corrente.
Tipo di risultato: un numero intero rappresentante i minuti nel formato MM
Argomenti:
- OFFSET: (facoltativo) differenza (in numero di barre) tra la barra corrente e la barra contenente il dato da ottenere. Per esempio, per ottenere il dato di 2 barre precedenti la barra corrente, impostare l’OFFSET uguale a -2.
'La seguente riga di codice restituisce i minuti della barra corrente:
Dim m As Numeric = My.DateTime.Minute
'Risultato: se l'ora della barra corrente è 1215345002679, il risultato sarà 15
'La seguente riga di codice restituisce i minuti di 2 barre indietro:
Dim m As Numeric = My.DateTime.Minute(-2)
Month #
Restituisce il Mese della barra corrente o della barra ottenuta sommando l’argomento OFFSET alla barra corrente.
Tipo di risultato: un numero intero rappresentante il mese nel formato MM
Argomenti:
- OFFSET: (facoltativo) differenza (in numero di barre) tra la barra corrente e la barra contenente il dato da ottenere. Per esempio, per ottenere il dato di 2 barre precedenti la barra corrente, impostare l’OFFSET uguale a -2.
'La seguente riga di codice restituisce il mese della barra corrente:
Dim m As Numeric = My.DateTime.Month
'Risultato: se la data della barra corrente è 20230312, il risultato sarà 3
'La seguente riga di codice restituisce il mese di 2 barre indietro:
Dim m As Numeric = My.DateTime.Month(-2)
NanoSecond #
Restituisce i NanoSecondi (centinaia) della barra corrente o della barra ottenuta sommando l’argomento OFFSET alla barra corrente.
Tipo di risultato: un numero intero rappresentante i nanosecondi nel formato N
Argomenti:
- OFFSET: (facoltativo) differenza (in numero di barre) tra la barra corrente e la barra contenente il dato da ottenere. Per esempio, per ottenere il dato di 2 barre precedenti la barra corrente, impostare l’OFFSET uguale a -2.
'La seguente riga di codice restituisce i nanosecondi della barra corrente:
Dim n As Numeric = My.DateTime.NanoSecond
'Risultato: se l'ora della barra corrente è 1215345002679, il risultato sarà 9
'La seguente riga di codice restituisce i nanosecondi di 2 barre indietro:
Dim n As Numeric = My.DateTime.NanoSecond(-2)
Second #
Restituisce i Secondi della barra corrente o della barra ottenuta sommando l’argomento OFFSET alla barra corrente.
Tipo di risultato: un numero intero rappresentante i secondi nel formato SS
Argomenti:
- OFFSET: (facoltativo) differenza (in numero di barre) tra la barra corrente e la barra contenente il dato da ottenere. Per esempio, per ottenere il dato di 2 barre precedenti la barra corrente, impostare l’OFFSET uguale a -2.
'La seguente riga di codice restituisce i secondi della barra corrente:
Dim s As Numeric = My.DateTime.Second
'Risultato: se l'ora della barra corrente è 1215345002679, il risultato sarà 34
'La seguente riga di codice restituisce i secondi di 2 barre indietro:
Dim s As Numeric = My.DateTime.Second(-2)
Week #
Restituisce il numero della settimana della barra corrente o della barra ottenuta sommando l’argomento OFFSET alla barra corrente.
Tipo di risultato: un numero intero (da 1 a 53) rappresentante il numero della settimana
Argomenti:
- OFFSET: (facoltativo) differenza (in numero di barre) tra la barra corrente e la barra contenente il dato da ottenere. Per esempio, per ottenere il dato di 2 barre precedenti la barra corrente, impostare l’OFFSET uguale a -2.
'La seguente riga di codice restituisce il numero della settimana della barra corrente:
Dim w As Numeric = My.DateTime.Week
'La seguente riga di codice restituisce il numero della settimana di 2 barre indietro:
Dim w As Numeric = My.DateTime.Week(-2)
Year #
Restituisce l’Anno della barra corrente o della barra ottenuta sommando l’argomento OFFSET alla barra corrente.
Tipo di risultato: un numero intero rappresentante l’anno nel formato YYYY
Argomenti:
- OFFSET: (facoltativo) differenza (in numero di barre) tra la barra corrente e la barra contenente il dato da ottenere. Per esempio, per ottenere il dato di 2 barre precedenti la barra corrente, impostare l’OFFSET uguale a -2.
'La seguente riga di codice restituisce l'anno della barra corrente:
Dim y As Numeric = My.DateTime.Year
'Risultato: se la data della barra corrente è 20230312, il risultato sarà 2023
'La seguente riga di codice restituisce l'anno di 2 barre indietro:
Dim y As Numeric = My.DateTime.Year(-2)