DateTime Class
DateTime is a dedicated time helper for scripts that need formatting, comparison, or date math.
Tip: DateTime.now() will always use UTC time from the current instant. Call .toLocal() before formatting when you want user-facing local clock time.
DateTime.now()
Current time.
let now = DateTime.now().toLocal();
console.log(now.format("yyyy-MM-dd HH:mm:ss"));DateTime.parse(text, format?)
Parse a string into a DateTime.
let dt = DateTime.parse("2026-06-01 14:30:00", "yyyy-MM-dd HH:mm:ss").toLocal();
console.log(dt.format("yyyy-MM-dd HH:mm:ss"));DateTime.fromMillis(ms)
Create from a Unix timestamp in milliseconds.
let dt = DateTime.now().toLocal();
let result = DateTime.fromMillis(1711360800000);
console.log(result);getYear()
Read date fields.
let dt = DateTime.now().toLocal();
let result = dt.getYear();
console.log(result);getMonth()
Read date fields.
let dt = DateTime.now().toLocal();
let result = dt.getMonth();
console.log(result);getDay()
Read date fields.
let dt = DateTime.now().toLocal();
let result = dt.getDay();
console.log(result);getHour()
Read time fields.
let dt = DateTime.now().toLocal();
let result = dt.getHour();
console.log(result);getMinute()
Read time fields.
let dt = DateTime.now().toLocal();
let result = dt.getMinute();
console.log(result);getSecond()
Read time fields.
let dt = DateTime.now().toLocal();
let result = dt.getSecond();
console.log(result);getMillisecond()
Read time fields.
let dt = DateTime.now().toLocal();
let result = dt.getMillisecond();
console.log(result);getDayOfWeek()
Day of week (1 = Sunday … 7 = Saturday).
let dt = DateTime.now().toLocal();
let result = dt.getDayOfWeek();
console.log(result);setYear(...)
Set date parts.
let dt = DateTime.now().toLocal();
let result = dt.setYear('demo');
console.log(result);setMonth(...)
Set date parts.
let dt = DateTime.now().toLocal();
let result = dt.setMonth('demo');
console.log(result);setDay(...)
Set date parts.
let dt = DateTime.now().toLocal();
let result = dt.setDay('demo');
console.log(result);setHour(...)
Set time parts.
let dt = DateTime.now().toLocal();
let result = dt.setHour('demo');
console.log(result);setMinute(...)
Set time parts.
let dt = DateTime.now().toLocal();
let result = dt.setMinute('demo');
console.log(result);setSecond(...)
Set time parts.
let dt = DateTime.now().toLocal();
let result = dt.setSecond('demo');
console.log(result);setMillisecond(...)
Set time parts.
let dt = DateTime.now().toLocal();
let result = dt.setMillisecond('demo');
console.log(result);getTimeZone()
Read the active time zone id.
let dt = DateTime.now().toLocal();
let result = dt.getTimeZone();
console.log(result);setTimeZone(id)
Set the active time zone.
let dt = DateTime.now().toLocal();
dt.setTimeZone('statusPanel');toUTC()
Convert between UTC and local.
let dt = DateTime.now().toLocal();
let result = dt.toUTC();
console.log(result);toLocal()
Convert between UTC and local.
let dt = DateTime.now().toLocal();
let result = dt.toLocal();
console.log(result);addYears(...)
Date arithmetic.
let dt = DateTime.now().toLocal();
let result = dt.addYears('demo');
console.log(result);addMonths(...)
Date arithmetic.
let dt = DateTime.now().toLocal();
let result = dt.addMonths('demo');
console.log(result);addDays(...)
Date arithmetic.
let dt = DateTime.now().toLocal();
let result = dt.addDays('demo');
console.log(result);addHours(...)
Date arithmetic.
let dt = DateTime.now().toLocal();
let result = dt.addHours('demo');
console.log(result);addMinutes(...)
Date arithmetic.
let dt = DateTime.now().toLocal();
let result = dt.addMinutes('demo');
console.log(result);addSeconds(...)
Date arithmetic.
let dt = DateTime.now().toLocal();
let result = dt.addSeconds('demo');
console.log(result);addMilliseconds(...)
Date arithmetic.
let dt = DateTime.now().toLocal();
let result = dt.addMilliseconds('demo');
console.log(result);diff(other)
Difference in milliseconds.
let dt = DateTime.now().toLocal();
let result = dt.diff(DateTime.now());
console.log(result);isBefore(other)
Comparison helpers.
let dt = DateTime.now().toLocal();
let result = dt.isBefore(DateTime.now());
console.log(result);isAfter(other)
Comparison helpers.
let dt = DateTime.now().toLocal();
let result = dt.isAfter(DateTime.now());
console.log(result);equals(other)
Comparison helpers.
let dt = DateTime.now().toLocal();
let result = dt.equals(DateTime.now());
console.log(result);format(pattern?)
Format the value as text.
let now = DateTime.now().toLocal();
console.log(now.format("yyyy-MM-dd HH:mm:ss"));toMillis()
Convert back to milliseconds.
let dt = DateTime.now().toLocal();
let result = dt.toMillis();
console.log(result);Example:
let now = DateTime.now().toLocal();
console.log(now.format("yyyy-MM-dd HH:mm:ss"));
console.log(now.addDays(1).format("yyyy-MM-dd HH:mm:ss"));