> For the complete documentation index, see [llms.txt](https://docs.n8n.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.n8n.io/build/work-with-data/transform-data/expression-reference/datetime.md).

# Datetime

## *`DateTime`*.**`day`** <a href="#datetimeday" id="datetimeday"></a>

**Description:** The day of the month (1-31)

**Syntax:** *`DateTime`*.day

**Returns:** Number

**Type:** Luxon

**Examples:**

```javascript
// dt = "2024-03-30T18:49".toDateTime()
dt.day //=> 30
```

## *`DateTime`*.**`diffTo()`** <a href="#datetimediffto" id="datetimediffto"></a>

**Description:** Returns the difference between two DateTimes, in the given unit(s)

**Syntax:** *`DateTime`*.diffTo(otherDateTime, unit)

**Returns:** Number

**Source:** Custom n8n functionality

**Parameters:**

* `otherDateTime` (String|DateTime) - The moment to subtract the base DateTime from. Can be an ISO date string or a Luxon DateTime.
* `unit` (String|Array) - optional - The unit, or array of units, to return the result in. Possible values: `years`, `months`, `weeks`, `days`, `hours`, `minutes`, `seconds`, `milliseconds`.

**Examples:**

```javascript
// dt1 = "2024-03-30T18:49:07.234".toDateTime()
dt1.diffTo('2025-01-01', 'days') //=> 276.21
```

```javascript
// dt1 = "2024-03-30T18:49:07.234".toDateTime()
// dt2 = "2025-01-01T00:00:00.000".toDateTime()
dt1.diffTo(dt2, ['months', 'days']) //=> {'months':, 'days':}
```

```javascript
Note: should support both day and days, etc.
```

## *`DateTime`*.**`diffToNow()`** <a href="#datetimedifftonow" id="datetimedifftonow"></a>

**Description:** Returns the difference between the current moment and the DateTime, in the given unit(s). For a textual representation, use `toRelative()` instead.

**Syntax:** *`DateTime`*.diffToNow(unit)

**Returns:** Number

**Source:** Custom n8n functionality

**Parameters:**

* `unit` (String|Array) - optional - The unit, or array of units, to return the result in. Possible values: `years`, `months`, `weeks`, `days`, `hours`, `minutes`, `seconds`, `milliseconds`.

**Examples:**

```javascript
// dt = "2023-03-30T18:49:07.234".toDateTime()
dt.diffToNow('days') //=> 371.9
```

```javascript
// dt = "2023-03-30T18:49:07.234".toDateTime()
dt.diffToNow(['months', 'days']) //=> {"months":12, "days":5.9}
```

```javascript
Note: should support both day and days, etc.
```

## *`DateTime`*.**`endOf()`** <a href="#datetimeendof" id="datetimeendof"></a>

**Description:** Rounds the DateTime up to the end of one of its units, e.g. the end of the month

**Syntax:** *`DateTime`*.endOf(unit, opts)

**Returns:** DateTime

**Type:** Luxon

**Parameters:**

* `unit` (String) - The unit to round to the end of. Can be `year`, `quarter`, `month`, `week`, `day`, `hour`, `minute`, `second`, or `millisecond`.
* `opts` (Object) - optional - Object with options that affect the output. Possible properties: `useLocaleWeeks` (boolean): Whether to use the locale when calculating the start of the week. Defaults to false.

**Examples:**

```javascript
// dt = "2024-03-20T18:49".toDateTime()
dt.endOf('month') //=> 2024-03-31T23:59
```

## *`DateTime`*.**`equals()`** <a href="#datetimeequals" id="datetimeequals"></a>

**Description:** Returns `true` if the two DateTimes represent exactly the same moment and are in the same time zone. For a less strict comparison, use `hasSame()`.

**Syntax:** *`DateTime`*.equals(other)

**Returns:** Boolean

**Type:** Luxon

**Parameters:**

* `other` (DateTime) - The other DateTime to compare

**Examples:**

```javascript
// dt1 = "2024-03-20T18:49+01:00".toDateTime()
// dt2 = "2024-03-20T19:49+02:00".toDateTime()
dt1.equals(dt2) //=> false
```

## *`DateTime`*.**`extract()`** <a href="#datetimeextract" id="datetimeextract"></a>

**Description:** Extracts a part of the date or time, e.g. the month, as a number. To extract textual names instead, see `format()`.

**Syntax:** *`DateTime`*.extract(unit?)

**Returns:** Number

**Source:** Custom n8n functionality

**Parameters:**

* `unit` (String) - optional - The part of the date or time to return. One of: `year`, `month`, `week`, `day`, `hour`, `minute`, `second`

**Examples:**

```javascript
// dt = "2024-03-30T18:49".toDateTime()
dt.extract('month') //=> 3
```

```javascript
// dt = "2024-03-30T18:49".toDateTime()
dt.extract('hour') //=> 18
```

## *`DateTime`*.**`format()`** <a href="#datetimeformat" id="datetimeformat"></a>

**Description:** Converts the DateTime to a string, using the format specified. [Formatting guide](https://moment.github.io/luxon/#/formatting?id=table-of-tokens). For common formats, `toLocaleString()` may be easier.

**Syntax:** *`DateTime`*.format(fmt)

**Returns:** String

**Source:** Custom n8n functionality

**Parameters:**

* `fmt` (String) - The [format](https://moment.github.io/luxon/#/formatting?id=table-of-tokens) of the string to return

**Examples:**

```javascript
// dt = "2024-04-30T18:49".toDateTime()
dt.format('dd/LL/yyyy') //=> '30/04/2024'
```

```javascript
// dt = "2024-04-30T18:49".toDateTime()
dt.format('dd LLL yy') //=> '30 Apr 24'
dt.setLocale('fr').format('dd LLL yyyy') //=> '30 avr. 2024'
dt.format("HH 'hours and' mm 'minutes'") //=> '18 hours and 49 minutes'
```

## *`DateTime`*.**`hasSame()`** <a href="#datetimehassame" id="datetimehassame"></a>

**Description:** Returns `true` if the two DateTimes are the same, down to the unit specified. Time zones are ignored (only local times are compared), so use `toUTC()` first if needed.

**Syntax:** *`DateTime`*.hasSame(otherDateTime, unit)

**Returns:** Boolean

**Type:** Luxon

**Parameters:**

* `otherDateTime` (DateTime) - The other DateTime to compare
* `unit` (String) - The unit of time to check sameness down to. One of `year`, `quarter`, `month`, `week`, `day`, `hour`, `minute`, `second`, or `millisecond`.

**Examples:**

```javascript
// dt1 = "2024-03-20".toDateTime()
// dt2 = "2024-03-18".toDateTime()
dt1.hasSame(dt2, 'month') //=> true
```

```javascript
// dt1 = "1982-03-20".toDateTime()
// dt2 = "2024-03-18".toDateTime()
dt1.hasSame(dt2, 'month') //=> false
```

## *`DateTime`*.**`hour`** <a href="#datetimehour" id="datetimehour"></a>

**Description:** The hour of the day (0-23)

**Syntax:** *`DateTime`*.hour

**Returns:** Number

**Type:** Luxon

**Examples:**

```javascript
// dt = "2024-03-30T18:49".toDateTime()
dt.hour //=> 18
```

## *`DateTime`*.**`isBetween()`** <a href="#datetimeisbetween" id="datetimeisbetween"></a>

**Description:** Returns `true` if the DateTime lies between the two moments specified

**Syntax:** *`DateTime`*.isBetween(date1, date2)

**Returns:** Boolean

**Source:** Custom n8n functionality

**Parameters:**

* `date1` (String|DateTime) - The moment that the base DateTime must be after. Can be an ISO date string or a Luxon DateTime.
* `date2` (String|DateTime) - The moment that the base DateTime must be before. Can be an ISO date string or a Luxon DateTime.

**Examples:**

```javascript
// dt = "2024-03-30T18:49".toDateTime()
dt.isBetween('2020-06-01', '2025-06-01') //=> true
```

```javascript
// dt = "2024-03-30T18:49".toDateTime()
dt.isBetween('2020', $now) //=> true
```

## *`DateTime`*.**`isInDST`** <a href="#datetimeisindst" id="datetimeisindst"></a>

**Description:** Whether the DateTime is in daylight saving time

**Syntax:** *`DateTime`*.isInDST

**Returns:** Boolean

**Type:** Luxon

## *`DateTime`*.**`locale`** <a href="#datetimelocale" id="datetimelocale"></a>

**Description:** The locale of a DateTime, such 'en-GB'. The locale is used when formatting the DateTime.

**Syntax:** *`DateTime`*.locale

**Returns:** String

**Type:** Luxon

**Examples:**

```javascript
$now.locale //=> 'en-US'
```

## *`DateTime`*.**`millisecond`** <a href="#datetimemillisecond" id="datetimemillisecond"></a>

**Description:** The millisecond of the second (0-999)

**Syntax:** *`DateTime`*.millisecond

**Returns:** Number

**Type:** Luxon

**Examples:**

```javascript
// dt = "2024-03-30T18:49:07.234".toDateTime()
dt.millisecond //=> 234
```

## *`DateTime`*.**`minus()`** <a href="#datetimeminus" id="datetimeminus"></a>

**Description:** Subtracts a given period of time from the DateTime

**Syntax:** *`DateTime`*.minus(n, unit?)

**Returns:** DateTime

**Source:** Custom n8n functionality

**Parameters:**

* `n` (Number|Object) - The number of units to subtract. Or use a Luxon \<a href=”[https://moment.github.io/luxon/api-docs/index.html#duration”>Duration](https://moment.github.io/luxon/api-docs/index.html#duration”>Duration) object to subtract multiple units at once.
* `unit` (String) - optional - The units of the number. One of: `years`, `months`, `weeks`, `days`, `hours`, `minutes`, `seconds`, `milliseconds`

**Examples:**

```javascript
// dt = "2024-03-30T18:49".toDateTime()
dt.minus(7, 'days') //=> 2024-04-23T18:49
```

```javascript
// dt = "2024-03-30T18:49".toDateTime()
dt.minus(4, 'years') //=> 2020-04-30T18:49
```

## *`DateTime`*.**`minute`** <a href="#datetimeminute" id="datetimeminute"></a>

**Description:** The minute of the hour (0-59)

**Syntax:** *`DateTime`*.minute

**Returns:** Number

**Type:** Luxon

**Examples:**

```javascript
// dt = "2024-03-30T18:49".toDateTime()
dt.minute //=> 49
```

## *`DateTime`*.**`month`** <a href="#datetimemonth" id="datetimemonth"></a>

**Description:** The month (1-12)

**Syntax:** *`DateTime`*.month

**Returns:** Number

**Type:** Luxon

**Examples:**

```javascript
// dt = "2024-03-30T18:49".toDateTime()
dt.month //=> 3
```

## *`DateTime`*.**`monthLong`** <a href="#datetimemonthlong" id="datetimemonthlong"></a>

**Description:** The textual long month name, e.g. 'October'. Defaults to the system's locale if no locale has been specified.

**Syntax:** *`DateTime`*.monthLong

**Returns:** String

**Type:** Luxon

**Examples:**

```javascript
// dt = "2024-03-30T18:49".toDateTime()
dt.monthLong //=> 'March'
```

```javascript
// dt = "2024-03-30T18:49".toDateTime()
dt.setLocale('de-DE').monthLong //=> 'März'
```

## *`DateTime`*.**`monthShort`** <a href="#datetimemonthshort" id="datetimemonthshort"></a>

**Description:** The textual abbreviated month name, e.g. 'Oct'. Defaults to the system's locale if no locale has been specified.

**Syntax:** *`DateTime`*.monthShort

**Returns:** String

**Type:** Luxon

**Examples:**

```javascript
// dt = "2024-03-30T18:49".toDateTime()
dt.monthShort //=> 'Mar'
```

```javascript
// dt = "2024-03-30T18:49".toDateTime()
dt.setLocale('de-DE').monthShort //=> 'Mär'
```

## *`DateTime`*.**`plus()`** <a href="#datetimeplus" id="datetimeplus"></a>

**Description:** Adds a given period of time to the DateTime

**Syntax:** *`DateTime`*.plus(n, unit?)

**Returns:** DateTime

**Source:** Custom n8n functionality

**Parameters:**

* `n` (Number|Object) - The number of units to add. Or use a Luxon \<a href=”[https://moment.github.io/luxon/api-docs/index.html#duration”>Duration](https://moment.github.io/luxon/api-docs/index.html#duration”>Duration) object to add multiple units at once.
* `unit` (String) - optional - The units of the number. One of: `years`, `months`, `weeks`, `days`, `hours`, `minutes`, `seconds`, `milliseconds`

**Examples:**

```javascript
// dt = "2024-03-30T18:49".toDateTime()
dt.plus(7, 'days') //=> 2024-04-06T18:49
```

```javascript
// dt = "2024-03-30T18:49".toDateTime()
dt.plus(4, 'years') //=> 2028-04-30T18:49
```

## *`DateTime`*.**`quarter`** <a href="#datetimequarter" id="datetimequarter"></a>

**Description:** The quarter of the year (1-4)

**Syntax:** *`DateTime`*.quarter

**Returns:** Number

**Type:** Luxon

**Examples:**

```javascript
// dt = "2024-03-30T18:49".toDateTime()
dt.quarter //=> 1
```

## *`DateTime`*.**`second`** <a href="#datetimesecond" id="datetimesecond"></a>

**Description:** The second of the minute (0-59)

**Syntax:** *`DateTime`*.second

**Returns:** Number

**Type:** Luxon

**Examples:**

```javascript
// dt = "2024-03-30T18:49:07.234".toDateTime()
dt.second //=> 7
```

## *`DateTime`*.**`set()`** <a href="#datetimeset" id="datetimeset"></a>

**Description:** Assigns new values to specified units of the DateTime. To round a DateTime, see also `startOf()` and `endOf()`.

**Syntax:** *`DateTime`*.set(values)

**Returns:** DateTime

**Type:** Luxon

**Parameters:**

* `values` (Object) - An object containing the units to set and corresponding values to assign. Possible keys are `year`, `month`, `day`, `hour`, `minute`, `second` and `millsecond`.

**Examples:**

```javascript
// dt = "2024-03-30T18:49".toDateTime()
dt.set({year:1982, month:10}) //=> 1982-10-20T18:49
```

## *`DateTime`*.**`setLocale()`** <a href="#datetimesetlocale" id="datetimesetlocale"></a>

**Description:** Sets the locale, which determines the language and formatting for the DateTime. Useful when generating a textual representation of the DateTime, e.g. with `format()` or `toLocaleString()`.

**Syntax:** *`DateTime`*.setLocale(locale)

**Returns:** DateTime

**Type:** Luxon

**Parameters:**

* `locale` (String) - The locale to assign, e.g. ‘en-GB’ for British English or ‘pt-BR’ for Brazilian Portuguese. \<a href=”[https://www.localeplanet.com/icu/”>List](https://www.localeplanet.com/icu/”>List) (unofficial)

**Examples:**

```javascript
$now.setLocale('de-DE').toLocaleString({'dateStyle':'long'}) //=> 5. Oktober 2024
```

```javascript
$now.setLocale('fr-FR').toLocaleString({'dateStyle':'long'}) //=> 5 octobre 2024
```

## *`DateTime`*.**`setZone()`** <a href="#datetimesetzone" id="datetimesetzone"></a>

**Description:** Converts the DateTime to the given time zone. The DateTime still represents the same moment unless specified in the options. See also `toLocal()` and `toUTC()`.

**Syntax:** *`DateTime`*.setZone(zone, opts)

**Returns:** DateTime

**Type:** Luxon

**Parameters:**

* `zone` (String) - optional - A zone identifier, either in the format ‘America/New\_York’, 'UTC+3', or the strings 'local' or 'utc'
* `opts` (Object) - optional - Options that affect the output. Possible properties: `keepCalendarTime` (boolean): Whether to keep the time the same and only change the offset. Defaults to false.

**Examples:**

```javascript
// dt = "2024-01-01T00:00:00.000+02:00".toDateTime()
dt.setZone('America/Buenos_aires') //=> 2023-12-31T19:00:00.000-03:00
```

```javascript
// dt = "2024-01-01T00:00:00.000+02:00".toDateTime()
dt.setZone('UTC+7') //=> 2024-01-01T05:00:00.000+07:00
```

## *`DateTime`*.**`startOf()`** <a href="#datetimestartof" id="datetimestartof"></a>

**Description:** Rounds the DateTime down to the beginning of one of its units, e.g. the start of the month

**Syntax:** *`DateTime`*.startOf(unit, opts)

**Returns:** DateTime

**Type:** Luxon

**Parameters:**

* `unit` (String) - The unit to round to the beginning of. One of `year`, `quarter`, `month`, `week`, `day`, `hour`, `minute`, `second`, or `millisecond`.
* `opts` (Object) - optional - Object with options that affect the output. Possible properties: `useLocaleWeeks` (boolean): Whether to use the locale when calculating the start of the week. Defaults to false.

**Examples:**

```javascript
// dt = "2024-03-20T18:49".toDateTime()
dt.startOf('month') //=> 2024-03-01T00:00
```

## *`DateTime`*.**`toISO()`** <a href="#datetimetoiso" id="datetimetoiso"></a>

**Description:** Returns an ISO 8601-compliant string representation of the DateTime

**Syntax:** *`DateTime`*.toISO(opts)

**Returns:** String

**Type:** Luxon

**Parameters:**

* `opts` (Object) - optional - Configuration options. See \<a href=”[https://moment.github.io/luxon/api-docs/index.html#datetimetoiso”>Luxon](https://moment.github.io/luxon/api-docs/index.html#datetimetoiso”>Luxon) docs for more info.

**Examples:**

```javascript
$now.toISO() //=> 2024-04-05T18:44:55.525+02:00
```

## *`DateTime`*.**`toLocal()`** <a href="#datetimetolocal" id="datetimetolocal"></a>

**Description:** Converts a DateTime to the workflow’s local time zone. The DateTime still represents the same moment unless specified in the parameters. The workflow’s time zone can be set in the workflow settings.

**Syntax:** *`DateTime`*.toLocal()

**Returns:** DateTime

**Type:** Luxon

**Examples:**

```javascript
// dt = "2024-01-01T00:00:00.000Z".toDateTime()
dt.toLocal() //=> 2024-01-01T01:00:00.000+01:00, if time zone is Europe/Berlin
```

## *`DateTime`*.**`toLocaleString()`** <a href="#datetimetolocalestring" id="datetimetolocalestring"></a>

**Description:** Returns a localised string representing the DateTime, i.e. in the language and format corresponding to its locale. Defaults to the system's locale if none specified.

**Syntax:** *`DateTime`*.toLocaleString(formatOpts)

**Returns:** String

**Type:** Luxon

**Parameters:**

* `formatOpts` (Object) - optional - Configuration options for the rendering. See \<a href=”[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global\\\_Objects/Intl/DateTimeFormat/DateTimeFormat#parameters”>Intl.DateTimeFormat](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global\\_Objects/Intl/DateTimeFormat/DateTimeFormat#parameters”>Intl.DateTimeFormat) for a full list. Defaults to rendering a short date.

**Examples:**

```javascript
$now.toLocaleString() //=> '4/30/2024'
$now.toLocaleString({'dateStyle':'medium', 'timeStyle':'short'}) //=> 'Apr 30, 2024, 10:00 PM'
// (if in US English locale)
```

```javascript
$now.setLocale('de-DE').toLocaleString() //=> '30.4.2024'
```

```javascript
$now.toLocaleString({'dateStyle':'short'}) //=> '4/30/2024'
$now.toLocaleString({'dateStyle':'medium'}) //=> 'Apr 30, 2024'
$now.toLocaleString({'dateStyle':'long'}) //=> 'April 30, 2024'
$now.toLocaleString({'dateStyle':'full'}) //=> 'Tuesday, April 30, 2024'
// (if in US English locale)
```

```javascript
$now.toLocaleString({'year':'numeric', 'month':'numeric', 'day':'numeric'}) //=> '4/30/2024'
$now.toLocaleString({'year':'2-digit', 'month':'2-digit', 'day':'2-digit'}) //=> '04/30/24'
$now.toLocaleString({'month':'short', 'weekday':'short', 'day':'numeric'}) //=> 'Tue, Apr 30'
$now.toLocaleString({'month':'long', 'weekday':'long', 'day':'numeric'}) //=> 'Tuesday, April 30'
// (if in US English locale)
```

```javascript
$now.toLocaleString({'timeStyle':'short'}) //=> '10:00 PM'
$now.toLocaleString({'timeStyle':'medium'}) //=> '10:00:58 PM'
$now.toLocaleString({'timeStyle':'long'}) //=> '10:00:58 PM GMT+2'
$now.toLocaleString({'timeStyle':'full'}) //=> '10:00:58 PM Central European Summer Time'
// (if in US English locale)
```

```javascript
$now.toLocaleString({'hour':'numeric', 'minute':'numeric', hourCycle:'h24'}) //=> '22:00'
$now.toLocaleString({'hour':'2-digit', 'minute':'2-digit', hourCycle:'h12'}) //=> '10:00 PM'
// (if in US English locale)
```

## *`DateTime`*.**`toMillis()`** <a href="#datetimetomillis" id="datetimetomillis"></a>

**Description:** Returns a Unix timestamp in milliseconds (the number elapsed since 1st Jan 1970)

**Syntax:** *`DateTime`*.toMillis()

**Returns:** Number

**Type:** Luxon

**Examples:**

```javascript
$now.toMillis() //=> 1712334324677
```

## *`DateTime`*.**`toRelative()`** <a href="#datetimetorelative" id="datetimetorelative"></a>

**Description:** Returns a textual representation of the time relative to now, e.g. ‘in two days’. Rounds down by default.

**Syntax:** *`DateTime`*.toRelative(options)

**Returns:** String

**Type:** Luxon

**Parameters:**

* `options` (Object) - optional - Options that affect the output. Possible properties: `unit` = the unit to default to (`years`, `months`, `days`, etc.). `locale` = the language and formatting to use (e.g. `de`, `fr`)

**Examples:**

```javascript
$now.plus(1, 'day').toRelative() //=> "in 1 day"
```

```javascript
$now.plus(1, 'day').toRelative({unit:'hours'}) //=> "in 24 hours"
```

```javascript
$now.plus(1, 'day').toRelative({locale:'es'}) //=> "dentro de 1 día"
```

## *`DateTime`*.**`toSeconds()`** <a href="#datetimetoseconds" id="datetimetoseconds"></a>

**Description:** Returns a Unix timestamp in seconds (the number elapsed since 1st Jan 1970)

**Syntax:** *`DateTime`*.toSeconds()

**Returns:** Number

**Type:** Luxon

**Examples:**

```javascript
$now.toSeconds() //=> 1712334442.372
```

## *`DateTime`*.**`toString()`** <a href="#datetimetostring" id="datetimetostring"></a>

**Description:** Returns a string representation of the DateTime. Similar to `toISO()`. For more formatting options, see `format()` or `toLocaleString()`.

**Syntax:** *`DateTime`*.toString()

**Returns:** string

**Type:** Luxon

**Examples:**

```javascript
$now.toString() //=> 2024-04-05T18:44:55.525+02:00
```

## *`DateTime`*.**`toUTC()`** <a href="#datetimetoutc" id="datetimetoutc"></a>

**Description:** Converts a DateTime to the UTC time zone. The DateTime still represents the same moment unless specified in the parameters. Use `setZone()` to convert to other zones.

**Syntax:** *`DateTime`*.toUTC(offset, opts)

**Returns:** DateTime

**Type:** Luxon

**Parameters:**

* `offset` (Number) - optional - An offset from UTC in minutes
* `opts` (Object) - optional - Object with options that affect the output. Possible properties: `keepCalendarTime` (boolean): Whether to keep the time the same and only change the offset. Defaults to false.

**Examples:**

```javascript
// dt = "2024-01-01T00:00:00.000+02:00".toDateTime()
dt.toUTC() //=> 2023-12-31T22:00:00.000Z
```

## *`DateTime`*.**`weekday`** <a href="#datetimeweekday" id="datetimeweekday"></a>

**Description:** The day of the week. 1 is Monday and 7 is Sunday.

**Syntax:** *`DateTime`*.weekday

**Returns:** Number

**Type:** Luxon

**Examples:**

```javascript
// dt = "2024-03-30T18:49".toDateTime()
dt.weekday //=> 6
```

## *`DateTime`*.**`weekdayLong`** <a href="#datetimeweekdaylong" id="datetimeweekdaylong"></a>

**Description:** The textual long weekday name, e.g. 'Wednesday'. Defaults to the system's locale if no locale has been specified.

**Syntax:** *`DateTime`*.weekdayLong

**Returns:** String

**Type:** Luxon

**Examples:**

```javascript
// dt = "2024-03-30T18:49".toDateTime()
dt.weekdayLong //=> 'Saturday'
```

```javascript
// dt = "2024-03-30T18:49".toDateTime()
dt.setLocale('de-DE').weekdayLong //=> 'Samstag'
```

## *`DateTime`*.**`weekdayShort`** <a href="#datetimeweekdayshort" id="datetimeweekdayshort"></a>

**Description:** The textual abbreviated weekday name, e.g. 'Wed'. Defaults to the system's locale if no locale has been specified.

**Syntax:** *`DateTime`*.weekdayShort

**Returns:** String

**Type:** Luxon

**Examples:**

```javascript
// dt = "2024-03-30T18:49".toDateTime()
dt.weekdayShort //=> 'Sat'
```

```javascript
// dt = "2024-03-30T18:49".toDateTime()
dt.setLocale('fr-FR').weekdayShort //=> 'sam.'
```

## *`DateTime`*.**`weekNumber`** <a href="#datetimeweeknumber" id="datetimeweeknumber"></a>

**Description:** The week number of the year (1-52ish)

**Syntax:** *`DateTime`*.weekNumber

**Returns:** Number

**Type:** Luxon

**Examples:**

```javascript
// dt = "2024-03-30T18:49".toDateTime()
dt.weekNumber //=> 13
```

## *`DateTime`*.**`year`** <a href="#datetimeyear" id="datetimeyear"></a>

**Description:** The year

**Syntax:** *`DateTime`*.year

**Returns:** Number

**Type:** Luxon

**Examples:**

```javascript
// dt = "2024-03-30T18:49".toDateTime()
dt.year //=> 2024
```

## *`DateTime`*.**`zone`** <a href="#datetimezone" id="datetimezone"></a>

**Description:** The time zone associated with the DateTime

**Syntax:** *`DateTime`*.zone

**Returns:** Object

**Type:** Luxon

**Examples:**

```javascript
$now.zone //=> {"zoneName": "Europe/Berlin", "valid": true}
```


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.n8n.io/build/work-with-data/transform-data/expression-reference/datetime.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.