날짜 및 시간 변환 함수

  • 릴리스 버전: Xanadu
  • 업데이트 날짜 2024년 08월 01일
  • 읽기6분
  • 날짜 및 시간 변환 함수를 사용하여 날짜/시간 값에 대한 데이터 알약을 다시 계산하거나 다시 포맷합니다.

    날짜 및 시간 변환 함수에는 날짜/시간 또는 문자열 입력 데이터 정제가 필요합니다. 일부 함수는 기간 데이터 알약도 지원합니다. 날짜 및 시간 변환 함수를 적용할 때 올바른 입력 데이터 정제 유형을 사용해야 합니다. 날짜 및 시간 변환 함수가 부적절한 데이터 정제 유형에 적용되면 런타임에 데이터가 변환되지 않고 대신 입력 값이 반환됩니다. 플로우 런타임 값 확인에 대한 자세한 내용은 플로우 테스트 단원을 참조하십시오.

    주:
    런타임 날짜/시간은 현지화되지 않으며 UTC(조정된 범용 시간대) 시간대로 표시됩니다. 자세한 내용은 시간대시간대 표현을 참조하십시오.

    시간 추가

    일, 시, 분 또는 초를 날짜/시간, 날짜, 기한 또는 기간 입력에 더합니다.

    입력 데이터 정제 매개변수 출력 데이터 정제
    날짜/시간, 날짜, 기한 또는 기간
    주:
    입력이 날짜 또는 만료 날짜인 경우 변환은 시간 0, 분 0 및 초 0의 시간 값을 사용하여 전체 날짜/시간 값을 작성합니다.
    Duration - 더할 시간(일, 시간, 분, 초) 날짜/시간 - 지정된 날짜/시간 값을 더한 후 변환된 날짜/시간 값입니다. Duration
    그림 1. 예제
    • 입력 : 2019-09-12 11:00:00
    • 소요 시간: 3시간
    • 출력: 2019-09-12 14:00:00

    기간 빼기

    입력 날짜/시간, 날짜, 기한 또는 기간에서 일, 시간, 분 및/또는 초를 뺍니다.

    입력 데이터 정제 매개변수 출력 데이터 정제
    날짜/시간, 날짜, 기한 또는 기간
    주:
    입력이 날짜 또는 만료 날짜인 경우 변환은 시간 0, 분 0 및 초 0의 시간 값을 사용하여 전체 날짜/시간 값을 작성합니다.
    Duration - 일, 시간, 분, 초 단위로 뺄 시간을 입력합니다. 날짜/시간 - 지정된 값을 뺀 후 변환된 날짜/시간 값입니다. Duration
    그림 2. 예제
    • 입력 : 2019-09-12 11:00:00
    • 소요 시간: 2일 1시간 5분 10초
    • 출력 : 2019-09-10 09:54:50

    이 예시에서는 플로우가 원격 인스턴스에서 CMDB 구성 항목 기록을 검색합니다. 그런 다음 시간 빼기 변환 함수는 입력 날짜/시간에서 3시간을 빼서 생성됨 필드의 값을 지역화합니다.

    그림 3. 필드 값의 시간대 지역화
    필드 값의 시간대를 지역화합니다.

    현재까지 문자열

    입력 문자열을 날짜/시간으로 변환합니다.

    입력 데이터 정제 매개변수 출력 데이터 정제
    에 지정된 대로 서식이 지정된 문자열입니다. Input Date Format
    • Input Date Format - 입력 문자열의 날짜/시간 또는 날짜 형식
    • Custom Format - 문자열로 표시된 유효한 날짜/시간 또는 날짜 형식입니다. 사용자 지정 형식이 .Input Date Format
    날짜/시간
    주:
    • 사용자 지정 형식 입력의 날짜/시간 값이 완전하지 않은 경우 변환은 기본 날짜와 시간을 사용하여 전체 날짜/시간 값을 작성합니다. 이 경우 변환의 기본값은 현재 연도, 현재 월, 월의 1일, 시간 0, 분 0 및 초 0입니다. 예를 들어, 입력 데이터 알약 값이 2019년 10월 이고 사용자 지정 날짜 형식이 MMM yyyy 인 경우 출력은 2019-10-01 00:00:00이 됩니다.
    • 잘못된 데이터 정제 유형이나 잘못된 사용자 지정 형식을 사용하면 런타임 중에 플로우가 취소됩니다.
    그림 4. 예제
    • 입력: '1995-11-20'
    • 입력 날짜 형식: ISO 날짜(2004-06-28)
    • 출력: 1995년 11월 20일 00:00:00

    문자열 날짜

    입력 날짜/시간, 날짜 또는 만료 날짜를 문자열로 변환합니다. 입력 날짜/시간에 대한 날짜 형식을 선택합니다. 또는 입력 날짜/시간에 대한 사용자 지정 형식을 입력합니다.

    입력 데이터 정제 매개변수 출력 데이터 정제
    날짜/시간, 날짜 또는 만료 날짜
    • Output Date Format - 출력 문자열의 날짜/시간 또는 날짜 형식
    • Custom Format - 문자열로 표시된 유효한 날짜/시간 또는 날짜 형식입니다. 사용자 지정 형식을 날짜 형식으로 선택하는 경우에만 필요합니다.
    에 지정된 대로 서식이 지정된 문자열입니다. Output Date Format
    주:
    잘못된 입력 데이터 정제 유형 또는 잘못된 사용자 지정 형식을 사용하면 런타임 중에 플로우가 취소됩니다.
    그림 5. 예제
    • 입력: 1969년 12월 31일 14시 23분 57
    • 출력 날짜 형식: 사용자 지정(아래에 입력)
    • 사용자 지정 형식: "On" MMM dd, yyyy "at" hh:mm a
    • 출력: 'On Dec 31, 1969 at 2:23 PM'

    이 예시에서 플로우는 외부 공급업체 데이터베이스에서 사용자 [sys_user] 기록을 검색합니다. 날짜를 문자열로 변환 함수는 작성된 필드의 형식을 변환한 다음 기록과 연관된 날짜, 시간 및 이름을 기록합니다.

    그림 5. 날짜/시간 값을 문자열 값과 연결
    날짜/시간 값을 문자열 값과 연결합니다.

    사용자 지정 날짜 형식

    특정 날짜 및 시간 패턴 문자열의 시퀀스를 사용하여 사용자 지정 날짜 형식을 지정할 수 있습니다. 패턴 문자열은 A에서 Z까지 하나 이상의 대문자와 소문자로 구성됩니다. 따옴표 안의 텍스트는 무시되고 대신 날짜 출력에 복사됩니다.

    문자열 설명 출력 형식
    G 시대 지정자 텍스트 AD
    y 2019; 19
    Y 연중 주 2019; 19
    M 월/연도(날짜 이내) 7월; 7월; 07
    L 월/연도(독립 실행형 값) 7월; 7월; 07
    W 연중 주 번호 52
    W 주/월 번호 1
    아래로 일/년 중 번호 365
    d 일/월 번호 2
    F 요일(월 중) 번호 3
    E 요일 주(week)의 이름 텍스트 수요일; 수
    u 요일 번호 번호 3
    a 오전 또는 오후 텍스트 오후.
    H 0에서 23까지의 시간 번호 0
    k 1에서 24까지의 시간 번호 24
    K 오전 0시 또는 오후 0시부터 11시까지 번호 0
    h 오전 1시 또는 오후 1시부터 12시까지 번호 12
    m 분/시 번호 59
    s 초/분 번호 1
    S 밀리초 번호 500
    z 기본 형식의 시간대 기본 형식의 시간대 태평양 표준시; 태평양 표준시
    Z RFC 822 형식의 시간대 RFC 822 형식의 시간대 -0800
    X ISO 8601 형식의 표준 시간대 ISO 8601 형식의 표준 시간대 -08; -0800; -08:00

    지정된 날짜/시간에서 일 구성요소를 검색합니다.

    입력 데이터 정제 출력 데이터 정제
    날짜/시간 정수 - 지정된 날짜의 일.
    그림 7. 예제
    • 입력 : 2021-11-20 13:06:12
    • 입력 날짜 형식: ISO 날짜(2004-06-28)
    • 출력: 20

    시간

    지정된 날짜/시간에서 시간 구성요소를 조회합니다.

    입력 데이터 정제 출력 데이터 정제
    날짜/시간 정수 - 지정된 날짜로부터의 시간입니다.
    그림 8. 예제
    • 입력 : 2021-11-20 13:06:12
    • 입력 날짜 형식: ISO 날짜(2004-06-28)
    • 출력:13

    지정된 날짜/시간에서 분 구성요소를 조회합니다.

    입력 데이터 정제 출력 데이터 정제
    날짜/시간 정수 - 지정된 날짜의 분 구성요소입니다.
    그림 9. 예제
    • 입력 : 2021-11-20 13:06:12
    • 입력 날짜 형식: ISO 날짜(2004-06-28)
    • 출력: 06

    두 번째

    지정된 날짜/시간에서 두 번째 구성요소를 조회합니다.

    입력 데이터 정제 출력 데이터 정제
    날짜/시간 정수 - 지정된 날짜의 초 구성요소입니다.
    그림 10. 예제
    • 입력 : 2021-11-20 13:06:12
    • 입력 날짜 형식: ISO 날짜(2004-06-28)
    • 출력: 12

    지정된 날짜/시간에서 월 구성요소를 검색합니다.

    입력 데이터 정제 출력 데이터 정제
    날짜/시간 정수 - 지정된 날짜의 월 구성요소입니다.
    그림 11. 예제
    • 입력 : 2021-11-20 13:06:12
    • 입력 날짜 형식: ISO 날짜(2004-06-28)
    • 출력: 11

    지정된 날짜/시간의 주 번호를 평가합니다.

    입력 데이터 정제 출력 데이터 정제
    날짜/시간 정수 - 지정된 날짜의 주 번호입니다.
    그림 12. 예제
    • 입력 : 2021-04-07 12:01:12
    • 입력 날짜 형식: ISO 날짜(2004-06-28)
    • 출력: 15

    지정된 날짜/시간에서 연도 구성요소를 검색합니다.
    입력 데이터 정제 출력 데이터 정제
    날짜/시간 정수 - 지정된 날짜의 연도 구성요소입니다.
    그림 13. 예제
    • 입력 : 2021-04-07 12:01:12
    • 입력 날짜 형식: ISO 날짜(2004-06-28)
    • 출력: 2021

    날짜 차이

    지정된 입력 날짜와 매개변수 날짜 사이의 시간 기간 차이를 평가한 다음 Epoch 시간(1970-01-01 00:00:00)에 차이 기간을 추가합니다.

    입력 데이터 정제 매개변수 출력 데이터 정제
    날짜/시간, 날짜 또는 만료 날짜 날짜/시간, 날짜 또는 만료 날짜 기간 - Epoch 시간(1970-01-01 00:00:00)에 추가된 기간 차이입니다.
    그림 14. 예제
    • 입력 : 2021-05-02 09:10:12
    • 입력 날짜 형식: ISO 날짜(2004-06-28)
    • 매개변수: 2021-04-07 06:02:23
    • 출력: 1970-01-26 03:07:49

    월말

    지정된 날짜에 지정된 월 수를 더한 후 월의 마지막 날을 평가합니다.

    입력 데이터 정제 매개변수 출력 데이터 정제
    날짜 월 수 - 지정된 날짜에 추가할 월입니다. 정수 - 지정된 입력 날짜에 개월 수를 더한 후의 마지막 날입니다.
    그림 15. 예제
    • 입력: 2021-11-20
    • 입력 날짜 형식: ISO 날짜(2004-06-28)
    • 개월 수: 3
    • 출력: 2022-02-28