날짜 및 시간#
Date & Time 노드는 날짜 및 시간 데이터를 조작하고 이를 다른 형식으로 변환합니다.
시간대 설정
이 노드는 시간대 설정에 따라 동작합니다. n8n은 다음 시간대 설정을 사용합니다:
- 워크플로에서 시간대를 설정한 경우 해당 시간대를 사용합니다.
자세한 내용은 워크플로 설정 문서를 참고하세요. - 워크플로에서 시간대를 설정하지 않은 경우, n8n 인스턴스의 시간대를 사용합니다.
* 자체 호스팅(Self-hosted) 인스턴스의 기본 시간대는America/New York
입니다.
* n8n Cloud는 가입 시 인스턴스 소유자의 시간대를 자동 감지하려 시도하며, 감지되지 않을 경우 기본값으로 GMT를 사용합니다.
* 자체 호스팅 사용자는 환경 변수를 통해 인스턴스 시간대를 변경할 수 있습니다.
* n8n Cloud 관리자는 관리자 대시보드(Admin dashboard)에서 인스턴스 시간대를 변경할 수 있습니다.
다른 노드에서의 날짜와 시간
Code 노드 및 모든 노드의 표현식에서 날짜와 시간을 다룰 수 있습니다. n8n은 JavaScript에서 날짜와 시간을 다루는 데 도움을 주기 위해 Luxon을 지원합니다. 더 자세한 내용은 Luxon으로 날짜와 시간 다루기를 참조하세요.
작업#
- 날짜에 추가: 날짜에 특정 시간 양을 추가합니다.
- 날짜 부분 추출: 연도, 월 또는 일과 같은 날짜의 일부를 추출합니다.
- 날짜 형식 지정: 미리 설정된 옵션 또는 사용자 정의 표현식을 사용하여 날짜 형식을 새 형식으로 변환합니다.
- 현재 날짜 가져오기: 현재 날짜를 가져오고 현재 시간을 포함할지 여부를 선택합니다. 다른 흐름과 조건 논리를 촉발하는 데 유용합니다.
- 두 날짜 사이의 시간 얻기: 두 날짜 사이의 특정 단위로 시간을 계산합니다.
- 날짜 반올림: 선택한 단위(예: 월, 일, 또는 시)로 날짜를 위 또는 아래로 반올림합니다.
- 날짜에서 빼기: 날짜에서 지정된 양의 시간을 뺍니다.
각 작업에 대한 매개변수 및 옵션은 아래 섹션을 참조하세요.
날짜에 추가#
이 작업을 위해 노드를 다음 매개변수로 구성하세요:
- 추가할 날짜: 변경할 날짜를 입력하세요.
- 추가할 시간 단위: Duration 매개변수의 시간 단위를 선택하세요.
- 지속 시간: 날짜에 추가할 시간 단위를 입력하세요.
- 출력 필드 이름: 새 날짜를 출력할 필드의 이름을 입력하세요.
날짜에 추가 옵션#
이 작업에는 하나의 옵션이 있습니다: 입력 필드 포함. 출력에 모든 입력 필드를 포함하고 싶다면 이 옵션을 켭니다. 꺼진 경우, 출력 필드 이름과 그 내용만 출력됩니다.
날짜 부분 추출#
이 작업을 위해 노드를 다음 매개변수로 구성하세요:
- 날짜: 반올림하거나 일부를 추출할 날짜를 입력하세요.
- 부분: 추출할 날짜의 부분을 선택하세요. 다음 중에서 선택:
- 연도
- 월
- 주
- 일
- 시
- 분
- 초
- 출력 필드 이름: 추출된 날짜 부분을 출력할 필드의 이름을 입력하세요.
날짜 부분 추출 옵션#
이 작업에는 하나의 옵션이 있습니다: 입력 필드 포함. 출력에 모든 입력 필드를 포함하고 싶다면 이 옵션을 켭니다. 꺼진 경우, 출력 필드 이름과 그 내용만 출력됩니다.
날짜 형식 지정#
이 작업을 위해 노드를 다음 매개변수로 구성하세요:
- 날짜: 형식을 지정할 날짜를 입력하세요.
- 형식: 날짜를 변경할 형식을 선택하세요. 다음 중에서 선택:
- 사용자 정의 형식: Luxon의 특수 토큰을 사용하여 사용자 정의 형식을 입력하세요. 토큰은 대소문자를 구분합니다.
- MM/DD/YYYY:
1986년 9월 4일
의 경우, 날짜는09/04/1986
으로 형식화됩니다. - YYYY/MM/DD:
1986년 9월 4일
의 경우, 날짜는1986/09/04
로 형식화됩니다. - MMMM DD YYYY:
1986년 9월 4일
의 경우, 날짜는September 04 1986
으로 형식화됩니다. - MM-DD-YYYY:
1986년 9월 4일
의 경우, 날짜는09-04-1986
으로 형식화됩니다. - YYYY-MM-DD:
1986년 9월 4일
의 경우, 날짜는1986-09-04
로 형식화됩니다.
- 출력 필드 이름: 형식이 지정된 날짜를 출력할 필드의 이름을 입력하세요.
날짜 형식 옵션#
이 작업에는 다음 옵션이 포함됩니다:
- 입력 필드 포함: 출력에 모든 입력 필드를 포함하려면 이 옵션을 켭니다. 꺼져 있으면 출력 필드 이름과 그 내용만 출력됩니다.
- 날짜 형식: 노드가 날짜 형식을 제대로 인식하지 못하는 경우, 노드가 이를 올바르게 처리할 수 있도록 해당 날짜의 형식을 여기에 입력합니다. Luxon의 특별 토큰을 사용하여 형식을 입력합니다. 토큰은 대소문자를 구분합니다.
- 워크플로우 시간대 사용: 입력의 시간대(꺼짐) 또는 워크플로우의 시간대(켜짐)를 사용할지 여부입니다.
현재 날짜 가져오기#
이 작업을 구성하는 매개변수는 다음과 같습니다:
- 현재 시간 포함: 현재 시간을 포함할지(켜짐) 또는 시간을 자정으로 설정할지(꺼짐 선택) 결정합니다.
- 출력 필드 이름: 현재 날짜를 출력할 필드의 이름을 입력합니다.
현재 날짜 가져오기 옵션#
이 작업에는 다음 옵션이 포함됩니다:
- 입력 필드 포함: 출력에 모든 입력 필드를 포함하려면 이 옵션을 켭니다. 꺼져 있으면 출력 필드 이름과 그 내용만 출력됩니다.
- 시간대: 사용할 시간대를 설정합니다. 비워 두면 노드는 n8n 인스턴스의 시간대를 사용합니다.
+00:00 시간대
+00:00 시간대의 경우 GMT
를 사용하세요.
날짜 사이의 시간 가져오기#
이 작업을 구성하는 매개변수는 다음과 같습니다:
- 시작 날짜: 비교할 이전 날짜를 입력합니다.
- 종료 날짜: 비교할 이후 날짜를 입력합니다.
- 단위: 시간 차이를 계산할 단위를 선택합니다. 여러 단위를 포함할 수 있습니다. 다음 중에서 선택하세요:
- 년
- 월
- 주
- 일
- 시간
- 분
- 초
- 밀리초
- 출력 필드 이름: 계산된 시간 차이를 출력할 필드의 이름을 입력합니다.
날짜 사이의 시간 가져오기 옵션#
날짜 사이의 시간 가져오기 작업에는 입력 필드 포함 옵션과 ISO 문자열로 출력 옵션이 포함됩니다. 이 옵션을 끄면 선택한 각 단위가 각각의 시간 차이 계산을 반환합니다. 예를 들어:
1 2 3 4 |
|
ISO 문자열로 출력 옵션을 켜면 노드는 출력을 단일 ISO 기간 문자열로 형식화합니다. 예: P1Y3M13D
.
ISO 기간 형식은 P<n>Y<n>M<n>DT<n>H<n>M<n>S
의 형식으로 표시됩니다. <n>
은 각 단위 뒤의 숫자입니다.
- P = 기간 (duration). 모든 ISO 기간 문자열의 시작입니다.
- Y = 년
- M = 월
- W = 주
- D = 일
- T = 날짜와 시간 사이의 구분 기호로, 월과 분 사이의 혼동을 피하기 위해 사용됩니다.
- H = 시간
- M = 분
- S = 초
밀리초는 별도의 단위가 아니며 소수 초로 표시됩니다. 예를 들어, 2.1 밀리초는 0.0021S
입니다.
날짜 반올림#
이 작업을 구성하는 매개변수는 다음과 같습니다:
- 날짜: 반올림할 날짜를 입력합니다.
- 모드: 내림 또는 올림 중에서 선택합니다.
- 가장 가까운 단위: 반올림할 단위를 선택합니다. 다음 중에서 선택하세요:
- 년
- 월
- 주
- 일
- 시간
- 분
- 초
- 출력 필드 이름: 반올림된 날짜를 출력할 필드의 이름을 입력합니다.
날짜 반올림 옵션#
이 작업에는 하나의 옵션이 있습니다: 입력 필드 포함. 출력에 모든 입력 필드를 포함하려면 이 옵션을 켜세요. 꺼져 있으면 출력 필드 이름과 그 내용만 출력됩니다.
날짜에서 빼기#
이 작업을 위해 노드를 다음 매개변수를 사용하여 구성합니다:
- 빼고 싶은 날짜: 빼고 싶은 날짜를 입력하세요.
- 빼고 싶은 시간 단위: 빼고 싶은 지속 시간의 단위를 선택하세요.
- 지속 시간: 빼고 싶은 날짜에서 빼고 싶은 시간 단위의 양을 입력하세요.
- 출력 필드 이름: 반올림된 날짜를 출력할 필드의 이름을 입력하세요.
날짜에서 빼기 옵션#
이 작업에는 하나의 옵션이 있습니다: 입력 필드 포함. 출력에 모든 입력 필드를 포함하려면 이 옵션을 켜세요. 꺼져 있으면 출력 필드 이름과 그 내용만 출력됩니다.
템플릿 및 예제#
관련 자료#
Date & Time 노드는 Luxon을 사용합니다. Code 노드와 expression에서도 Luxon을 사용할 수 있습니다. 자세한 내용은 Luxon을 이용한 날짜 및 시간을 참조하세요.
지원되는 날짜 형식#
n8n은 Luxon에서 지원하는 모든 날짜 형식을 지원합니다. 토큰은 대소문자를 구분합니다.