---
title: "Data și ora"
description: "Data și ora în scripturile TapHome: ora curentă cu NOW, construirea datelor cu DATETIME, adăugarea de zile sau ore, durate cu TIMESPAN, decalajul fusului orar și timpul Unix."
url: "https://taphome.com/ro/docs/script/date-and-time/"
language: ro
lastmod: 2026-11-06
generator: hugo
ai:
  topics: ["date-time","timespan","timezone","scripting-language"]
  questions: ["Cum se lucrează cu data și ora în scripturile TapHome?","Cum se creează un obiect DateTime în TapHome?","Cum se obțin data și ora curente într-un script TapHome?","Cum se reprezintă o durată cu TIMESPAN?","Cum se adaugă sau se scade timp dintr-un DateTime cu DATETIMEADD?","Cum se obține decalajul fusului orar local în TapHome?","Ce proprietăți are un obiect DateTime?","Cum se verifică într-un script dacă astăzi este weekend?","Cum se convertește un marcaj de timp Unix într-o dată într-un script TapHome?","Cum se calculează numărul de minute dintre două date?"]
---

# Data și ora

Funcțiile de dată și oră ale scripturilor TapHome — NOW, DATETIME, DATETIMEADD, TIMESPAN și LOCALTIMEZONE — și proprietățile valorilor datetime și timespan.

Ultima actualizare: 2026-11-06

Funcțiile de dată și oră creează valori `datetime` (un moment în timp) și valori `timespan` (o durată). Funcționează în fiecare script — smart rules, notificări, Modbus și Packet parser — și folosesc fusul orar al unității de control. Toate funcțiile de pe această pagină necesită Core 2022.2 sau mai nou.

## NOW

`NOW` returnează data și ora curente ale unității de control ca valoare `datetime` — implicit ora locală, UTC cu `NOW(Utc)`.

```text
NOW()
NOW(kind)
```

| Nume | Tip | Descriere |
|---|---|---|
| `kind` | `DateTimeKind`, opțional | `Local` (implicit) sau `Utc`. `NOW(DateTimeKind.Utc)` este același lucru cu `NOW(Utc)`. |

**Observații** — O proprietate nu se poate citi direct dintr-un apel de funcție: `NOW().HOUR` este respins la salvarea scriptului. Valoarea se stochează mai întâi într-o variabilă.

**Exemplu**

```taphome
VAR now := NOW();
now.HOUR;
# Result: the current hour, 0 to 23
```

**Consultați și** — [DATETIME](https://taphome.com/ro/docs/script/date-and-time/#datetime), [Proprietățile valorilor datetime](https://taphome.com/ro/docs/script/date-and-time/#datetime-properties).

## DATETIME

`DATETIME` creează o valoare `datetime` din părțile ei, dintr-un text sau dintr-un număr de milisecunde; apelată fără argumente, returnează 1.1.0001 00:00, nu ora curentă — pentru aceasta se folosește [NOW](https://taphome.com/ro/docs/script/date-and-time/#now).

```text
DATETIME(year, month, day [, hour [, minute [, second [, millisecond [, kind]]]]])
DATETIME(text [, format])
DATETIME(text, kind)
DATETIME(milliseconds [, kind])
DATETIME()
```

| Nume | Tip | Descriere |
|---|---|---|
| `year`, `month`, `day` | număr | Obligatorii împreună. Părțile de timp omise sunt 0. |
| `hour` … `millisecond` | număr, opțional | Ora din zi. |
| `kind` | `DateTimeKind`, opțional | `Local` (implicit) sau `Utc`. |
| `text` | string | Data și ora ca text. |
| `format` | string, opțional | Formatul .NET al lui `text`, de exemplu `"dd.MM.yyyy HH:mm"`. |
| `milliseconds` | număr | Milisecunde de la 1.1.0001 — scara proprietății `TICKS`, nu timpul Unix. |

**Observații**

- Un text fără format se citește conform setărilor de limbă ale unității de control. Se folosește ISO 8601 (`"2026-01-15T08:30:00"`) sau se transmite un format, astfel încât rezultatul să nu depindă de ele.
- Un text cu decalaj sau cu `Z` (`"2026-01-15T08:30:00Z"`) se păstrează ca valoare UTC. Cu `kind` setat la `Utc`, un text fără informații despre fus se citește ca UTC.
- Pentru timpul Unix se setează [proprietatea UNIXTIME](https://taphome.com/ro/docs/script/date-and-time/#datetime-properties).

**Exemplu**

```taphome
# data din părți: an, lună, zi, oră
VAR start := DATETIME(2026, 1, 15, 8, 30, 0);
# data din text ISO 8601 și din text cu format
VAR iso := DATETIME("2026-01-15T08:30:00");
VAR custom := DATETIME("15.01.2026 08:30", "dd.MM.yyyy HH:mm");
# data din părți, marcată ca UTC
VAR utc := DATETIME(2026, 1, 15, 8, 30, 0, 0, DateTimeKind.Utc);
# minutul datei interpretate
custom.MINUTE;
# Result: 30
```

## DATETIMEADD

`DATETIMEADD` returnează un `datetime` nou, deplasat cu numărul dat de ani, luni, zile, ore, minute, secunde și milisecunde; numerele negative îl deplasează înapoi.

```text
DATETIMEADD(datetime, years [, months [, days [, hours [, minutes [, seconds [, milliseconds]]]]]])
```

**Observații** — Valoarea originală nu se modifică. Adăugarea unei luni la 31 ianuarie dă ultima zi a lunii februarie. Pentru a adăuga un interval se poate folosi și `+` cu un [timespan](https://taphome.com/ro/docs/script/date-and-time/#timespan) sau cu un număr de milisecunde.

**Exemplu**

```taphome
# ora curentă a unității de control
VAR now := NOW();
# o zi înainte, două ore înapoi
VAR tomorrow := DATETIMEADD(now, 0, 0, 1);
VAR twoHoursAgo := DATETIMEADD(now, 0, 0, 0, -2);
# o lună după 31 ianuarie
VAR endOfFebruary := DATETIMEADD(DATETIME(2026, 1, 31), 0, 1);
# ziua rezultatului
endOfFebruary.DAY;
# Result: 28
```

## TIMESPAN

`TIMESPAN` creează o valoare `timespan` — o durată — fie din milisecunde, fie din zile, ore, minute, secunde și milisecunde.

```text
TIMESPAN(milliseconds)
TIMESPAN(days, hours, minutes, seconds, milliseconds)
```

**Proprietăți** (numai citire)

| Proprietate | Semnificație |
|---|---|
| `DAYS`, `HOURS`, `MINUTES`, `SECONDS`, `MILLISECONDS` | O componentă a duratei (`HOURS` este 0 – 23). |
| `TOTALDAYS`, `TOTALHOURS`, `TOTALMINUTES`, `TOTALSECONDS`, `TOTALMILLISECONDS` | Întreaga durată în acea unitate, cu parte fracționară. |

**Observații**

- Există doar formele cu 1 și cu 5 argumente; între 2 și 4 argumente opresc scriptul.
- `timespan ± timespan` dă un `timespan`, `datetime ± timespan` un `datetime`.
- Scăderea a două valori `datetime` nu este definită. Pentru timpul dintre două date se scad valorile lor `TICKS` (milisecunde).
- Declararea unei variabile cu cuvântul cheie de tip `timespan` necesită Core 2023.2 sau mai nou.

**Exemplu**

```taphome
VAR t := TIMESPAN(1, 2, 3, 4, 0);
t.TOTALSECONDS;
# Result: 93784
```

```taphome
VAR start := DATETIME(2026, 1, 15, 8, 0, 0);
VAR stop := DATETIME(2026, 1, 15, 9, 30, 0);
(stop.TICKS - start.TICKS) / 60000;
# Result: 90 (minutes)
```

**Erori** — *TIMESPAN Unsupported number of parameters*; *Operator '-' not defined for 'DateTime' and 'DateTime'*.

## LOCALTIMEZONE

`LOCALTIMEZONE` returnează decalajul curent al fusului orar al unității de control față de UTC, în milisecunde, inclusiv ora de vară.

```text
LOCALTIMEZONE()
```

**Exemplu**

```taphome
LOCALTIMEZONE() / 3600000;
# Result: 1 in Central European winter time, 2 in summer time
```

## Proprietățile valorilor datetime

O valoare `datetime` are aceste proprietăți. Se citesc dintr-o variabilă, nu dintr-un apel de funcție.

| Proprietate | Citire | Scriere | Observație |
|---|---|---|---|
| `TICKS` | ✓ | ✓ | Milisecunde de la 1.1.0001. |
| `YEAR`, `MONTH`, `DAY` | ✓ | ✓ | Scrierea verifică intervalul (`MONTH` 1 – 12, `DAY` 1 – ultima zi a lunii). |
| `HOUR`, `MINUTE`, `SECOND`, `MILLISECOND` | ✓ | ✓ | Intervale 0 – 23, 0 – 59, 0 – 59, 0 – 999. |
| `DAYOFWEEK` | ✓ | | Valoare `DayOfWeek` (`Monday` … `Sunday`). |
| `DAYOFYEAR` | ✓ | | 1 – 366. |
| `KIND` | ✓ | ✓ | `DateTimeKind`: `Local`, `Utc` sau `Unspecified`. |
| `UTCDATETIME`, `LOCALDATETIME` | ✓ | | Același moment convertit cu fusul orar al unității de control. |
| `UNIXTIME` | ✓ | ✓ | Secunde de la 1.1.1970 UTC. Scrierea ei stochează o valoare UTC. |

**Observații**

- În afara unui argument de funcție, o valoare de enumerare se scrie cu tipul ei: `DayOfWeek.Saturday`. Un `Saturday` simplu este o variabilă necunoscută.
- `<`, `>` și `=` compară două valori `datetime` ca momente în timp, așa că valorile cu `KIND` diferit se compară corect.
- Scrierea unei valori în afara intervalului oprește scriptul, de exemplu *Value must between 0-23*.
- Fără format, [TOSTRING](https://taphome.com/ro/docs/script/data-type-conversions/#tostring) afișează un `datetime` ca `yyyy/MM/dd hh:mm:ss.fff` — ceas de 12 ore fără AM sau PM. Se transmite un format precum `"yyyy-MM-dd HH:mm"`.

**Exemplu — nicio acțiune în weekend**

```taphome
# ora curentă a unității de control
VAR now := NOW();
# sâmbăta și duminica returnează 0
IF now.DAYOFWEEK = DayOfWeek.Saturday OR now.DAYOFWEEK = DayOfWeek.Sunday
    RETURN(0);
END
# în celelalte zile returnează 1
1;
```

**Exemplu — dată dintr-un marcaj de timp Unix**

```taphome
datetime d;
d.UNIXTIME := 1767225600;
d.YEAR;
# Result: 2026 (1 January 2026, 00:00 UTC)
```

**Consultați și** — [Șiruri de format](https://taphome.com/ro/docs/script/data-type-conversions/#format-strings), [Tipuri de date](https://taphome.com/ro/docs/script/data-types/).
