---
title: Overbasic – Funzioni Data/Ora
description: "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…"
url: "https://www.overcharts.com/it/helpcenter/docs/overbasic-funzioni-data-ora/"
updated: "2022-12-23"
category: "Overbasic / Funzioni Built-In"
---

# 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)
```