---
title: "Datum i vrijeme"
description: "Datum i vrijeme u skripti TapHome: trenutačno vrijeme s NOW, sastavljanje datuma s DATETIME, dodavanje dana ili sati, trajanja s TIMESPAN, pomak vremenske zone i Unix vrijeme."
url: "https://taphome.com/hr/docs/script/date-and-time/"
language: hr
lastmod: 2026-11-06
generator: hugo
ai:
  topics: ["date-time","timespan","timezone","scripting-language"]
  questions: ["Kako raditi s datumom i vremenom u skriptama TapHome?","Kako u sustavu TapHome stvoriti objekt DateTime?","Kako u skripti TapHome dobiti trenutačni datum i vrijeme?","Kako pomoću TIMESPAN prikazati trajanje?","Kako pomoću DATETIMEADD dodati ili oduzeti vrijeme od vrijednosti DateTime?","Kako u sustavu TapHome dobiti pomak lokalne vremenske zone?","Koja svojstva ima objekt DateTime?","Kako u skripti provjeriti je li danas vikend?","Kako u skripti TapHome pretvoriti Unix vremensku oznaku u datum?","Kako izračunati broj minuta između dvaju datuma?"]
---

# Datum i vrijeme

Funkcije skripte TapHome za datum i vrijeme — NOW, DATETIME, DATETIMEADD, TIMESPAN i LOCALTIMEZONE — i svojstva vrijednosti datetime i timespan.

Posljednje ažuriranje: 2026-11-06

Funkcije za datum i vrijeme stvaraju vrijednosti `datetime` (trenutak u vremenu) i vrijednosti `timespan` (trajanje). Rade u svakoj skripti — smart rules, obavijesti, Modbus i Packet parser — i koriste vremensku zonu centralne jedinice. Sve funkcije na ovoj stranici trebaju Core 2022.2 ili noviji.

## NOW

`NOW` vraća trenutačni datum i vrijeme centralne jedinice kao vrijednost `datetime` — zadano lokalno vrijeme, UTC s `NOW(Utc)`.

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

| Naziv | Tip | Opis |
|---|---|---|
| `kind` | `DateTimeKind`, neobavezno | `Local` (zadano) ili `Utc`. `NOW(DateTimeKind.Utc)` isto je što i `NOW(Utc)`. |

**Napomene** — Svojstvo se ne može čitati izravno iz poziva funkcije: `NOW().HOUR` se odbija pri spremanju skripte. Vrijednost najprije spremite u varijablu.

**Primjer**

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

**Vidi također** — [DATETIME](https://taphome.com/hr/docs/script/date-and-time/#datetime), [Svojstva vrijednosti datetime](https://taphome.com/hr/docs/script/date-and-time/#datetime-properties).

## DATETIME

`DATETIME` stvara vrijednost `datetime` iz njezinih dijelova, iz teksta ili iz broja milisekundi; pozvan bez argumenata vraća 1.1.0001 00:00, a ne trenutačno vrijeme — za to koristite [NOW](https://taphome.com/hr/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()
```

| Naziv | Tip | Opis |
|---|---|---|
| `year`, `month`, `day` | broj | Obavezni zajedno. Izostavljeni dijelovi vremena su 0. |
| `hour` … `millisecond` | broj, neobavezno | Vrijeme u danu. |
| `kind` | `DateTimeKind`, neobavezno | `Local` (zadano) ili `Utc`. |
| `text` | string | Datum i vrijeme kao tekst. |
| `format` | string, neobavezno | .NET format teksta `text`, na primjer `"dd.MM.yyyy HH:mm"`. |
| `milliseconds` | broj | Milisekunde od 1.1.0001 — mjerilo svojstva `TICKS`, a ne Unix vrijeme. |

**Napomene**

- Tekst bez formata čita se prema jezičnim postavkama centralne jedinice. Koristite ISO 8601 (`"2026-01-15T08:30:00"`) ili zadajte format kako rezultat ne bi ovisio o njima.
- Tekst s pomakom ili sa `Z` (`"2026-01-15T08:30:00Z"`) zadržava se kao vrijednost UTC. Kada je `kind` postavljen na `Utc`, tekst bez podatka o zoni čita se kao UTC.
- Za Unix vrijeme postavite [svojstvo UNIXTIME](https://taphome.com/hr/docs/script/date-and-time/#datetime-properties).

**Primjer**

```taphome
# datum iz dijelova: godina, mjesec, dan, vrijeme
VAR start := DATETIME(2026, 1, 15, 8, 30, 0);
# datum iz teksta ISO 8601 i iz teksta s formatom
VAR iso := DATETIME("2026-01-15T08:30:00");
VAR custom := DATETIME("15.01.2026 08:30", "dd.MM.yyyy HH:mm");
# datum iz dijelova, označen kao UTC
VAR utc := DATETIME(2026, 1, 15, 8, 30, 0, 0, DateTimeKind.Utc);
# minuta obrađenog datuma
custom.MINUTE;
# Result: 30
```

## DATETIMEADD

`DATETIMEADD` vraća novu vrijednost `datetime` pomaknutu za zadani broj godina, mjeseci, dana, sati, minuta, sekundi i milisekundi; negativni brojevi pomiču je unatrag.

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

**Napomene** — Izvorna vrijednost se ne mijenja. Dodavanje mjeseca 31. siječnja daje posljednji dan veljače. Za dodavanje intervala možete koristiti i `+` s vrijednošću [timespan](https://taphome.com/hr/docs/script/date-and-time/#timespan) ili s brojem milisekundi.

**Primjer**

```taphome
# trenutačno vrijeme centralne jedinice
VAR now := NOW();
# jedan dan unaprijed, dva sata unatrag
VAR tomorrow := DATETIMEADD(now, 0, 0, 1);
VAR twoHoursAgo := DATETIMEADD(now, 0, 0, 0, -2);
# mjesec nakon 31. siječnja
VAR endOfFebruary := DATETIMEADD(DATETIME(2026, 1, 31), 0, 1);
# dan rezultata
endOfFebruary.DAY;
# Result: 28
```

## TIMESPAN

`TIMESPAN` stvara vrijednost `timespan` — trajanje — iz milisekundi ili iz dana, sati, minuta, sekundi i milisekundi.

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

**Svojstva** (samo za čitanje)

| Svojstvo | Značenje |
|---|---|
| `DAYS`, `HOURS`, `MINUTES`, `SECONDS`, `MILLISECONDS` | Jedna sastavnica trajanja (`HOURS` je 0 – 23). |
| `TOTALDAYS`, `TOTALHOURS`, `TOTALMINUTES`, `TOTALSECONDS`, `TOTALMILLISECONDS` | Cijelo trajanje u toj jedinici, s decimalnim dijelom. |

**Napomene**

- Postoje samo oblici s 1 i s 5 argumenata; 2 do 4 argumenta zaustavljaju skriptu.
- `timespan ± timespan` daje `timespan`, `datetime ± timespan` daje `datetime`.
- Oduzimanje dviju vrijednosti `datetime` nije definirano. Za vrijeme između dvaju datuma oduzmite njihove `TICKS` (milisekunde).
- Deklaracija varijable ključnom riječi tipa `timespan` treba Core 2023.2 ili noviji.

**Primjer**

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

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

## LOCALTIMEZONE

`LOCALTIMEZONE` vraća trenutačni pomak vremenske zone centralne jedinice od UTC-a u milisekundama, uključujući ljetno računanje vremena.

```text
LOCALTIMEZONE()
```

**Primjer**

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

## Svojstva vrijednosti datetime

Vrijednost `datetime` ima ova svojstva. Čitajte ih iz varijable, a ne iz poziva funkcije.

| Svojstvo | Čitanje | Pisanje | Napomena |
|---|---|---|---|
| `TICKS` | ✓ | ✓ | Milisekunde od 1.1.0001. |
| `YEAR`, `MONTH`, `DAY` | ✓ | ✓ | Pisanje provjerava raspon (`MONTH` 1 – 12, `DAY` 1 – posljednji dan u mjesecu). |
| `HOUR`, `MINUTE`, `SECOND`, `MILLISECOND` | ✓ | ✓ | Rasponi 0 – 23, 0 – 59, 0 – 59, 0 – 999. |
| `DAYOFWEEK` | ✓ | | Vrijednost `DayOfWeek` (`Monday` … `Sunday`). |
| `DAYOFYEAR` | ✓ | | 1 – 366. |
| `KIND` | ✓ | ✓ | `DateTimeKind`: `Local`, `Utc` ili `Unspecified`. |
| `UTCDATETIME`, `LOCALDATETIME` | ✓ | | Isti trenutak pretvoren prema vremenskoj zoni centralne jedinice. |
| `UNIXTIME` | ✓ | ✓ | Sekunde od 1.1.1970 UTC. Pisanje sprema vrijednost UTC. |

**Napomene**

- Izvan argumenta funkcije vrijednost enuma piše se s njezinim tipom: `DayOfWeek.Saturday`. Sam `Saturday` je nepoznata varijabla.
- `<`, `>` i `=` uspoređuju dvije vrijednosti `datetime` kao trenutke u vremenu, pa se vrijednosti različitog `KIND` ispravno uspoređuju.
- Upis vrijednosti izvan raspona zaustavlja skriptu, na primjer *Value must between 0-23*.
- Bez formata [TOSTRING](https://taphome.com/hr/docs/script/data-type-conversions/#tostring) ispisuje `datetime` kao `yyyy/MM/dd hh:mm:ss.fff` — 12-satni prikaz bez AM ili PM. Zadajte format kao `"yyyy-MM-dd HH:mm"`.

**Primjer — bez radnje vikendom**

```taphome
# trenutačno vrijeme centralne jedinice
VAR now := NOW();
# subotom i nedjeljom vrati 0
IF now.DAYOFWEEK = DayOfWeek.Saturday OR now.DAYOFWEEK = DayOfWeek.Sunday
    RETURN(0);
END
# ostalim danima vrati 1
1;
```

**Primjer — datum iz Unix vremenske oznake**

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

**Vidi također** — [Nizovi formata](https://taphome.com/hr/docs/script/data-type-conversions/#format-strings), [Tipovi podataka](https://taphome.com/hr/docs/script/data-types/).
