Overbasic – Funzioni Data/Ora

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)