DateTime.day#

설명: 월의 일 (1-31)

구문: DateTime.day

반환값: Number

타입: Luxon

예시:

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

DateTime.diffTo()#

설명: 두 DateTime 간의 차이를 지정한 단위로 반환합니다.

구문: DateTime.diffTo(otherDateTime, unit)

반환값: Number

출처: n8n 커스텀 기능

파라미터:

• otherDateTime (String|DateTime) - 기준 DateTime에서 뺄 시점. ISO 날짜 문자열 또는 Luxon DateTime을 사용할 수 있습니다.
• unit (String|Array) - optional - 결과를 반환할 단위 또는 단위 배열. 가능한 값: years, months, weeks, days, hours, minutes, seconds, milliseconds.

예시:

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

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

Note: should support both day and days, etc.

DateTime.diffToNow()#

설명: 현재 시점과 DateTime 간의 차이를 지정한 단위로 반환합니다. 텍스트 형식으로 표현하려면 toRelative()를 사용하세요.

구문: DateTime.diffToNow(unit)

반환값: Number

출처: n8n 커스텀 기능

파라미터:

• unit (String|Array) - optional - 결과를 반환할 단위 또는 단위 배열. 가능한 값: years, months, weeks, days, hours, minutes, seconds, milliseconds.

예시:

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

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

Note: should support both day and days, etc.

DateTime.endOf()#

설명: DateTime을 특정 단위의 끝으로 올림합니다. 예: 월의 마지막 날.

구문: DateTime.endOf(unit, opts)

반환값: DateTime

타입: Luxon

파라미터:

• unit (String) - 끝으로 올림할 단위. year, quarter, month, week, day, hour, minute, second, millisecond 중 하나.
• opts (Object) - optional - 출력에 영향을 주는 옵션 객체. 가능한 속성: useLocaleWeeks (boolean): 주의 시작을 계산할 때 로케일을 사용할지 여부. 기본값은 false.

예시:

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

DateTime.equals()#

설명: 두 DateTime이 정확히 같은 시점을 나타내고 같은 시간대에 있으면 true를 반환합니다. 덜 엄격한 비교를 하려면 hasSame()을 사용하세요.

구문: DateTime.equals(other)

반환값: Boolean

타입: Luxon

파라미터:

• other (DateTime) - 비교할 다른 DateTime

예시:

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

DateTime.extract()#

설명: 날짜 또는 시간의 특정 부분(예: 월)을 숫자로 추출합니다. 텍스트 이름으로 추출하려면 format()을 참조하세요.

구문: DateTime.extract(unit?)

반환값: Number

출처: n8n 커스텀 기능

파라미터:

• unit (String) - optional - 반환할 날짜 또는 시간의 부분. year, month, week, day, hour, minute, second 중 하나.

예시:

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

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

DateTime.format()#

설명: DateTime을 지정한 형식의 문자열로 변환합니다. 서식 지정 가이드. 일반적인 형식에는 toLocaleString()이 더 편리할 수 있습니다.

구문: DateTime.format(fmt)

반환값: String

출처: n8n 커스텀 기능

파라미터:

• fmt (String) - 반환할 문자열의 형식

예시:

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

// 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()#

설명: 두 DateTime이 지정된 단위까지 같으면 true를 반환합니다. 시간대는 무시되고 로컬 시간만 비교되므로, 필요한 경우 먼저 toUTC()를 사용하세요.

구문: DateTime.hasSame(otherDateTime, unit)

반환값: Boolean

타입: Luxon

파라미터:

• otherDateTime (DateTime) - 비교할 다른 DateTime
• unit (String) - 동일 여부를 확인할 시간 단위. year, quarter, month, week, day, hour, minute, second, millisecond 중 하나.

예시:

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

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

DateTime.hour#

설명: 시간대의 시 (0-23)

구문: DateTime.hour

반환값: Number

타입: Luxon

예시:

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

DateTime.isBetween()#

설명: DateTime이 지정한 두 시점 사이에 있으면 true를 반환합니다.

구문: DateTime.isBetween(date1, date2)

반환값: Boolean

출처: n8n 커스텀 기능

파라미터:

• date1 (String|DateTime) - 기준 DateTime이 이후여야 하는 시점. ISO 날짜 문자열 또는 Luxon DateTime을 사용할 수 있습니다.
• date2 (String|DateTime) - 기준 DateTime이 이전이어야 하는 시점. ISO 날짜 문자열 또는 Luxon DateTime을 사용할 수 있습니다.

예시:

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

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

DateTime.isInDST#

설명: DateTime이 일광 절약 시간(DST)에 해당하는지 여부

구문: DateTime.isInDST

반환값: Boolean

타입: Luxon

DateTime.locale#

설명: DateTime의 로케일(예: 'en-GB'). 로케일은 DateTime을 서식화할 때 사용됩니다.

구문: DateTime.locale

반환값: String

타입: Luxon

예시:

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

DateTime.millisecond#

설명: 초의 밀리초 (0-999)

구문: DateTime.millisecond

반환값: Number

타입: Luxon

예시:

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

DateTime.minus()#

설명: DateTime에서 주어진 기간을 뺍니다.

구문: DateTime.minus(n, unit?)

반환값: DateTime

출처: n8n 커스텀 기능

파라미터:

• n (Number|Object) - 뺄 단위의 수. 또는 Luxon Duration 객체를 사용하여 여러 단위를 한 번에 뺄 수 있습니다.
• unit (String) - optional - 수의 단위. years, months, weeks, days, hours, minutes, seconds, milliseconds 중 하나.

예시:

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

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

DateTime.minute#

설명: 시간의 분 (0-59)

구문: DateTime.minute

반환값: Number

타입: Luxon

예시:

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

DateTime.month#

설명: 월 (1-12)

구문: DateTime.month

반환값: Number

타입: Luxon

예시:

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

DateTime.monthLong#

설명: 월의 긴 텍스트 이름(예: 'October'). 로케일이 지정되지 않은 경우 시스템 로케일을 기본값으로 사용합니다.

구문: DateTime.monthLong

반환값: String

타입: Luxon

예시:

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

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

DateTime.monthShort#

설명: 월의 축약된 텍스트 이름(예: 'Oct'). 로케일이 지정되지 않은 경우 시스템 로케일을 기본값으로 사용합니다.

구문: DateTime.monthShort

반환값: String

타입: Luxon

예시:

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

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

DateTime.plus()#

설명: DateTime에 주어진 기간을 더합니다.

구문: DateTime.plus(n, unit?)

반환값: DateTime

출처: n8n 커스텀 기능

파라미터:

• n (Number|Object) - 더할 단위의 수. 또는 Luxon Duration 객체를 사용하여 여러 단위를 한 번에 더할 수 있습니다.
• unit (String) - optional - 수의 단위. years, months, weeks, days, hours, minutes, seconds, milliseconds 중 하나.

예시:

// dt = "2024-03-30T18:49".toDateTime()
dt.plus(7, 'days') //=> 2024-05-07T18:49

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

DateTime.quarter#

설명: 연도의 분기 (1-4)

구문: DateTime.quarter

반환값: Number

타입: Luxon

예시:

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

DateTime.second#

설명: 분의 초 (0-59)

구문: DateTime.second

반환값: Number

타입: Luxon

예시:

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

DateTime.set()#

설명: DateTime의 특정 단위에 새 값을 할당합니다. DateTime을 반올림하려면 startOf()와 endOf()도 참조하세요.

구문: DateTime.set(values)

반환값: DateTime

타입: Luxon

파라미터:

• values (Object) - 설정할 단위와 해당 값이 담긴 객체. 가능한 키: year, month, day, hour, minute, second, millsecond.

예시:

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

DateTime.setLocale()#

설명: DateTime의 언어와 서식을 결정하는 로케일을 설정합니다. format()이나 toLocaleString()으로 텍스트 표현을 생성할 때 유용합니다.

구문: DateTime.setLocale(locale)

반환값: DateTime

타입: Luxon

파라미터:

• locale (String) - 할당할 로케일(예: 영국 영어는 'en-GB', 브라질 포르투갈어는 'pt-BR'). 목록 (비공식)

예시:

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

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

DateTime.setZone()#

설명: DateTime을 지정한 시간대로 변환합니다. 옵션에서 지정하지 않는 한 DateTime은 동일한 시점을 나타냅니다. toLocal()과 toUTC()도 참조하세요.

구문: DateTime.setZone(zone, opts)

반환값: DateTime

타입: Luxon

파라미터:

• zone (String) - optional - 시간대 식별자. 'America/New_York', 'UTC+3' 형식 또는 'local', 'utc' 문자열.
• opts (Object) - optional - 출력에 영향을 주는 옵션. 가능한 속성: keepCalendarTime (boolean): 시간을 동일하게 유지하고 오프셋만 변경할지 여부. 기본값은 false.

예시:

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

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

DateTime.startOf()#

설명: DateTime을 특정 단위의 시작으로 내림합니다. 예: 월의 첫째 날.

구문: DateTime.startOf(unit, opts)

반환값: DateTime

타입: Luxon

파라미터:

• unit (String) - 시작으로 내림할 단위. year, quarter, month, week, day, hour, minute, second, millisecond 중 하나.
• opts (Object) - optional - 출력에 영향을 주는 옵션 객체. 가능한 속성: useLocaleWeeks (boolean): 주의 시작을 계산할 때 로케일을 사용할지 여부. 기본값은 false.

예시:

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

DateTime.toISO()#

설명: DateTime의 ISO 8601 호환 문자열 표현을 반환합니다.

구문: DateTime.toISO(opts)

반환값: String

타입: Luxon

파라미터:

• opts (Object) - optional - 구성 옵션. 자세한 내용은 Luxon 문서를 참조하세요.

예시:

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

DateTime.toLocal()#

설명: DateTime을 워크플로우의 로컬 시간대로 변환합니다. 파라미터에서 지정하지 않는 한 DateTime은 동일한 시점을 나타냅니다. 워크플로우의 시간대는 워크플로우 설정에서 지정할 수 있습니다.

구문: DateTime.toLocal()

반환값: DateTime

타입: Luxon

예시:

// 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()#

설명: DateTime을 로케일에 맞는 문자열로 반환합니다. 즉, 해당 로케일의 언어와 형식으로 표현됩니다. 로케일이 지정되지 않은 경우 시스템 로케일을 기본값으로 사용합니다.

구문: DateTime.toLocaleString(formatOpts)

반환값: String

타입: Luxon

파라미터:

• formatOpts (Object) - optional - 렌더링을 위한 구성 옵션. 전체 목록은 Intl.DateTimeFormat을 참조하세요. 기본값은 짧은 날짜 형식입니다.

예시:

$now.toLocaleString() //=> '4/30/2024'
$now.toLocaleString({'dateStyle':'medium', 'timeStyle':'short'}) //=> 'Apr 30, 2024, 10:00 PM'
// (미국 영어 로케일인 경우)

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

$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'
// (미국 영어 로케일인 경우)

$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'
// (미국 영어 로케일인 경우)

$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'
// (미국 영어 로케일인 경우)

$now.toLocaleString({'hour':'numeric', 'minute':'numeric', hourCycle:'h24'}) //=> '22:00'
$now.toLocaleString({'hour':'2-digit', 'minute':'2-digit', hourCycle:'h12'}) //=> '10:00 PM'
// (미국 영어 로케일인 경우)

DateTime.toMillis()#

설명: Unix 타임스탬프를 밀리초 단위로 반환합니다 (1970년 1월 1일 이후 경과 시간).

구문: DateTime.toMillis()

반환값: Number

타입: Luxon

예시:

$now.toMillis() //=> 1712334324677

DateTime.toRelative()#

설명: 현재 시점 기준 상대적인 시간의 텍스트 표현을 반환합니다(예: 'in two days'). 기본적으로 내림됩니다.

구문: DateTime.toRelative(options)

반환값: String

타입: Luxon

파라미터:

• options (Object) - optional - 출력에 영향을 주는 옵션. 가능한 속성: unit = 기본 단위 (years, months, days 등). locale = 사용할 언어 및 서식(예: de, fr)

예시:

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

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

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

DateTime.toSeconds()#

설명: Unix 타임스탬프를 초 단위로 반환합니다 (1970년 1월 1일 이후 경과 시간).

구문: DateTime.toSeconds()

반환값: Number

타입: Luxon

예시:

$now.toSeconds() //=> 1712334442.372

DateTime.toString()#

설명: DateTime의 문자열 표현을 반환합니다. toISO()와 유사합니다. 더 많은 서식 옵션은 format() 또는 toLocaleString()을 참조하세요.

구문: DateTime.toString()

반환값: string

타입: Luxon

예시:

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

DateTime.toUTC()#

설명: DateTime을 UTC 시간대로 변환합니다. 파라미터에서 지정하지 않는 한 DateTime은 동일한 시점을 나타냅니다. 다른 시간대로 변환하려면 setZone()을 사용하세요.

구문: DateTime.toUTC(offset, opts)

반환값: DateTime

타입: Luxon

파라미터:

• offset (Number) - optional - UTC로부터의 오프셋(분 단위)
• opts (Object) - optional - 출력에 영향을 주는 옵션 객체. 가능한 속성: keepCalendarTime (boolean): 시간을 동일하게 유지하고 오프셋만 변경할지 여부. 기본값은 false.

예시:

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

DateTime.weekday#

설명: 요일. 1은 월요일, 7은 일요일입니다.

구문: DateTime.weekday

반환값: Number

타입: Luxon

예시:

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

DateTime.weekdayLong#

설명: 요일의 긴 텍스트 이름(예: 'Wednesday'). 로케일이 지정되지 않은 경우 시스템 로케일을 기본값으로 사용합니다.

구문: DateTime.weekdayLong

반환값: String

타입: Luxon

예시:

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

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

DateTime.weekdayShort#

설명: 요일의 축약된 텍스트 이름(예: 'Wed'). 로케일이 지정되지 않은 경우 시스템 로케일을 기본값으로 사용합니다.

구문: DateTime.weekdayShort

반환값: String

타입: Luxon

예시:

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

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

DateTime.weekNumber#

설명: 연도의 주 번호 (1-52 내외)

구문: DateTime.weekNumber

반환값: Number

타입: Luxon

예시:

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

DateTime.year#

설명: 연도

구문: DateTime.year

반환값: Number

타입: Luxon

예시:

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

DateTime.zone#

설명: DateTime과 연결된 시간대

구문: DateTime.zone

반환값: Object

타입: Luxon

예시:

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