DateTime
n8n v2.29설명: 두 DateTime 간의 차이를 지정된 단위로 반환합니다 구문: DateTime.diffTo(otherDateTime, unit) 설명: 현재 시점과 DateTime 간의 차이를 지정된 단위로 반환합니다. 구문: DateTime.diffToNow(unit)
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) - 선택 사항 - 결과를 반환할 단위 또는 단위 배열입니다. 가능한 값: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) - 선택 사항 - 결과를 반환할 단위 또는 단위 배열입니다. 가능한 값: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) - 선택 사항 - 출력에 영향을 주는 옵션이 담긴 객체입니다. 가능한 속성: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) - 선택 사항 - 반환할 날짜 또는 시간의 부분입니다. 다음 중 하나: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) - 비교할 다른 DateTimeunit(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이 일광 절약 시간(서머타임)에 해당하는지 여부
구문: DateTime.isInDST
반환값: Boolean
유형: Luxon
DateTime.locale#
설명: 'en-GB'와 같은 DateTime의 로케일입니다. 이 로케일은 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 <a href=”https://moment.github.io/luxon/api-docs/index.html#duration”>Duration 객체를 사용해 여러 단위를 한 번에 뺄 수 있습니다.unit(String) - 선택 사항 - 숫자의 단위입니다. 다음 중 하나: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 <a href=”https://moment.github.io/luxon/api-docs/index.html#duration”>Duration 객체를 사용해 여러 단위를 한 번에 더할 수 있습니다.unit(String) - 선택 사항 - 숫자의 단위입니다. 다음 중 하나:years,months,weeks,days,hours,minutes,seconds,milliseconds
예시:
// dt = "2024-03-30T18:49".toDateTime()
dt.plus(7, 'days') //=> 2024-04-06T18: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의 텍스트 표현을 생성할 때 유용합니다.
구문: DateTime.setLocale(locale)
반환값: DateTime
유형: Luxon
매개변수:
locale(String) - 할당할 로케일입니다. 예: 영국식 영어는 'en-GB', 브라질 포르투갈어는 'pt-BR'. <a href=”https://www.localeplanet.com/icu/”>목록(비공식)
예시:
$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) - 선택 사항 - 'America/New_York' 형식이나 'UTC+3', 또는 'local'/'utc' 문자열 형태의 시간대 식별자opts(Object) - 선택 사항 - 출력에 영향을 주는 옵션입니다. 가능한 속성: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) - 선택 사항 - 출력에 영향을 주는 옵션이 담긴 객체입니다. 가능한 속성: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) - 선택 사항 - 구성 옵션입니다. 자세한 내용은 <a href=”https://moment.github.io/luxon/api-docs/index.html#datetimetoiso”>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) - 선택 사항 - 렌더링을 위한 구성 옵션입니다. 전체 목록은 <a href=”https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Intl/DateTimeFormat/DateTimeFormat#parameters”>Intl.DateTimeFormat을 참고하세요. 기본값은 짧은 날짜 형식을 렌더링합니다.
예시:
$now.toLocaleString() //=> '4/30/2024'
$now.toLocaleString({'dateStyle':'medium', 'timeStyle':'short'}) //=> 'Apr 30, 2024, 10:00 PM'
// (if in US English locale)
$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'
// (if in US English locale)
$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)
$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)
$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()#
설명: 밀리초 단위의 유닉스 타임스탬프(1970년 1월 1일 이후 경과한 수)를 반환합니다
구문: DateTime.toMillis()
반환값: Number
유형: Luxon
예시:
$now.toMillis() //=> 1712334324677
DateTime.toRelative()#
설명: 현재 시점 기준의 상대적 시간을 텍스트로 표현하여 반환합니다(예: 'in two days'). 기본적으로 내림합니다.
구문: DateTime.toRelative(options)
반환값: String
유형: Luxon
매개변수:
options(Object) - 선택 사항 - 출력에 영향을 주는 옵션입니다. 가능한 속성: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()#
설명: 초 단위의 유닉스 타임스탬프(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) - 선택 사항 - UTC로부터의 오프셋(분)opts(Object) - 선택 사항 - 출력에 영향을 주는 옵션이 담긴 객체입니다. 가능한 속성: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}