---
sourceDocument: Xanadu 빌드 워크플로우
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/ko-KR/xanadu/build-workflows

 Release :

    - xanadu

ft:locale :

    - ko-KR

ft:publication_title :

    - Xanadu 빌드 워크플로우

ft:clusterId :

    - crworkflow

bundleId :

    - crworkflow

workflow :

    - Creator


---

# 날짜 및 시간 변환 함수

# 날짜 및 시간 변환 함수 {#ariaid-title1}

* 릴리스 버전: Xanadu
* 
* 업데이트 날짜 2024년 08월 01일
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 소요 시간: 6분

날짜 및 시간 변환 함수를 사용하여 날짜/시간 값에 대한 데이터 알약을 다시 계산하거나 다시 포맷합니다.
날짜 및 시간 변환 함수에는 날짜/시간 또는 문자열 입력 데이터 정제가 필요합니다. 일부 함수는 기간 데이터 알약도 지원합니다. 날짜 및 시간 변환 함수를 적용할 때 올바른 입력 [데이터 정제 유형을](https://servicenow-prod.fluidtopics.net/iZzeOQfZQXdEMCfIFQImBQ "작업과 하위 플로우는 변수를 사용하여 입력 및 출력 데이터를 저장합니다. 변수 데이터 유형에 따라 저장하는 데이터의 종류와 고급 구성 옵션이 결정됩니다.") 사용해야 합니다. 날짜 및 시간 변환 함수가 부적절한 데이터 정제 유형에 적용되면 런타임에 데이터가 변환되지 않고 대신 입력 값이 반환됩니다. 플로우 런타임 값 확인에 대한 자세한 내용은 [플로우 테스트 단원을](https://servicenow-prod.fluidtopics.net/kFVIqIUbOAqHJ~azc0wl1Q "다른 사용자가 액세스할 수 있도록 플로우를 활성화하기 전에 테스트하여 예상대로 작동하는지 확인합니다.") 참조하십시오.  
주:  
런타임 날짜/시간은 현지화되지 않으며 UTC(조정된 범용 시간대) 시간대로 표시됩니다. 자세한 내용은 [시간대](https://www.servicenow.com/docs/access?context=r_TimeZones&version=xanadu&pubname=xanadu-platform-administration&ft:locale=en-US) 및 [시간대 표현을](https://support.servicenow.com/kb_view.do?sysparm_article=KB0594661) 참조하십시오.

## 시간 추가 {#date-time-transform-functions__add-time}

일, 시, 분 또는 초를 날짜/시간, 날짜, 기한 또는 기간 입력에 더합니다.  
{#date-time-transform-functions__table_elj_cdf_mkb__entry__3}

| 입력 데이터 정제 | 매개변수 | 출력 데이터 정제 |
|-|-|-|
| 날짜/시간, 날짜, 기한 또는 기간 주: 입력이 날짜 또는 만료 날짜인 경우 변환은 시간 0, 분 0 및 초 0의 시간 값을 사용하여 전체 날짜/시간 값을 작성합니다. | Duration - 더할 시간(일, 시간, 분, 초) | 날짜/시간 - 지정된 날짜/시간 값을 더한 후 변환된 날짜/시간 값입니다. Duration |
[ ]

{#date-time-transform-functions__table_elj_cdf_mkb}  
그림 1. 예제

* 입력 : `2019-09-12 11:00:00`
* 소요 시간: `3시간`
* 출력: `2019-09-12 14:00:00 `
{#date-time-transform-functions__ul_g5q_d5y_2jb}

## 기간 빼기 {#date-time-transform-functions__subtract-time}

입력 날짜/시간, 날짜, 기한 또는 기간에서 일, 시간, 분 및/또는 초를 뺍니다.  
{#date-time-transform-functions__table_lvd_jff_mkb__entry__3}

| 입력 데이터 정제 | 매개변수 | 출력 데이터 정제 |
|-|-|-|
| 날짜/시간, 날짜, 기한 또는 기간 주: 입력이 날짜 또는 만료 날짜인 경우 변환은 시간 0, 분 0 및 초 0의 시간 값을 사용하여 전체 날짜/시간 값을 작성합니다. | Duration - 일, 시간, 분, 초 단위로 뺄 시간을 입력합니다. | 날짜/시간 - 지정된 값을 뺀 후 변환된 날짜/시간 값입니다. Duration |
[ ]

{#date-time-transform-functions__table_lvd_jff_mkb}  
그림 2. 예제

* 입력 : `2019-09-12 11:00:00`
* 소요 시간: `2일 1시간 5분 10초`
* 출력 : `2019-09-10 09:54:50`
{#date-time-transform-functions__ul_mlj_4pz_2jb}

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

## 현재까지 문자열 {#date-time-transform-functions__string-to-date}

입력 문자열을 날짜/시간으로 변환합니다.  
{#date-time-transform-functions__table_crn_5ff_mkb__entry__3}

| 입력 데이터 정제 | 매개변수 | 출력 데이터 정제 |
|-|-|-|
| 에 지정된 대로 서식이 지정된 문자열입니다. Input Date Format | * Input Date Format - 입력 문자열의 날짜/시간 또는 날짜 형식 * Custom Format - 문자열로 표시된 유효한 날짜/시간 또는 날짜 형식입니다. 사용자 지정 형식이 .Input Date Format {#date-time-transform-functions__ul_e3c_grz_2jb} | 날짜/시간 |
[ ]

{#date-time-transform-functions__table_crn_5ff_mkb}  
주:  
* 사용자 지정 형식 입력의 날짜/시간 값이 완전하지 않은 경우 변환은 기본 날짜와 시간을 사용하여 전체 날짜/시간 값을 작성합니다. 이 경우 변환의 기본값은 현재 연도, 현재 월, 월의 1일, 시간 0, 분 0 및 초 0입니다. 예를 들어, 입력 데이터 알약 값이 2019년 10월 이고 사용자 지정 날짜 형식이 MMM yyyy 인 경우 `출력은 2019-10-01 00:00:00`이 됩니다.
* 잘못된 데이터 정제 유형이나 잘못된 사용자 지정 형식을 사용하면 런타임 중에 플로우가 취소됩니다.
{#date-time-transform-functions__ul_nfr_dnj_lkb}  
그림 4. 예제

* 입력: `'1995-11-20'`
* 입력 날짜 형식: `ISO 날짜(2004-06-28)`
* 출력: `1995년 11월 20일 00:00:00`
{#date-time-transform-functions__ul_g3c_grz_2jb}

## 문자열 날짜 {#date-time-transform-functions__date-to-string}

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

| 입력 데이터 정제 | 매개변수 | 출력 데이터 정제 |
|-|-|-|
| 날짜/시간, 날짜 또는 만료 날짜 | * Output Date Format - 출력 문자열의 날짜/시간 또는 날짜 형식 * Custom Format - 문자열로 표시된 유효한 날짜/시간 또는 날짜 형식입니다. 사용자 지정 형식을 날짜 형식으로 선택하는 경우에만 필요합니다. {#date-time-transform-functions__ul_sv5_3sz_2jb} | 에 지정된 대로 서식이 지정된 문자열입니다. Output Date Format |
[ ]

{#date-time-transform-functions__table_pxn_5gf_mkb}  
주:  
잘못된 입력 데이터 정제 유형 또는 잘못된 사용자 지정 형식을 사용하면 런타임 중에 플로우가 취소됩니다.  
그림 5. 예제

* 입력: `1969년 12월 31일 14시 23분 57`초
* 출력 날짜 형식: `사용자 지정(아래에 입력)`
* 사용자 지정 형식: `"On" MMM dd, yyyy "at" hh:mm a`
* 출력: `'On Dec 31, 1969 at 2:23 PM'`

{#date-time-transform-functions__ul_uv5_3sz_2jb}

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

## 사용자 지정 날짜 형식 {#date-time-transform-functions__section_x2t_fzx_gjb}

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

| 문자열 | 설명 | 출력 형식 | 예 |
|-|-|-|-|
| 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 |
[ ]

{#date-time-transform-functions__tbl_custom-date-formats}

## 일 {#date-time-transform-functions__section_nsj_4s3_grb}

지정된 날짜/시간에서 일 구성요소를 검색합니다.
{#date-time-transform-functions__table_cqp_vt3_grb__entry__2}

| 입력 데이터 정제 | 출력 데이터 정제 |
|-|-|
| 날짜/시간 | 정수 - 지정된 날짜의 일. |
[ ]

{#date-time-transform-functions__table_cqp_vt3_grb}  
그림 7. 예제

* 입력 : `2021-11-20 13:06:12`
* 입력 날짜 형식: `ISO 날짜(2004-06-28) `
* 출력: `20`
{#date-time-transform-functions__ul_wzn_dx3_grb}

## 시간 {#date-time-transform-functions__section_zkc_by3_grb}

지정된 날짜/시간에서 시간 구성요소를 조회합니다.
{#date-time-transform-functions__table_tw2_2y3_grb__entry__2}

| 입력 데이터 정제 | 출력 데이터 정제 |
|-|-|
| 날짜/시간 | 정수 - 지정된 날짜로부터의 시간입니다. |
[ ]

{#date-time-transform-functions__table_tw2_2y3_grb}  
그림 8. 예제

* 입력 : `2021-11-20 13:06:12`
* 입력 날짜 형식: `ISO 날짜(2004-06-28) `
* 출력:`13`
{#date-time-transform-functions__ul_mb1_ly3_grb}

## 분 {#date-time-transform-functions__section_ybw_yy3_grb}

지정된 날짜/시간에서 분 구성요소를 조회합니다.
{#date-time-transform-functions__table_bqh_kz3_grb__entry__2}

| 입력 데이터 정제 | 출력 데이터 정제 |
|-|-|
| 날짜/시간 | 정수 - 지정된 날짜의 분 구성요소입니다. |
[ ]

{#date-time-transform-functions__table_bqh_kz3_grb}  
그림 9. 예제

* 입력 : `2021-11-20 13:06:12`
* 입력 날짜 형식: `ISO 날짜(2004-06-28) `
* 출력: `06`
{#date-time-transform-functions__ul_rqq_dz3_grb}

## 두 번째 {#date-time-transform-functions__section_bnn_pz3_grb}

지정된 날짜/시간에서 두 번째 구성요소를 조회합니다.
{#date-time-transform-functions__table_zbl_sz3_grb__entry__2}

| 입력 데이터 정제 | 출력 데이터 정제 |
|-|-|
| 날짜/시간 | 정수 - 지정된 날짜의 초 구성요소입니다. |
[ ]

{#date-time-transform-functions__table_zbl_sz3_grb}  
그림 10. 예제

* 입력 : `2021-11-20 13:06:12`
* 입력 날짜 형식: `ISO 날짜(2004-06-28) `
* 출력: `12`
{#date-time-transform-functions__ul_rgl_wbj_grb}

## 월 {#date-time-transform-functions__section_swr_jcj_grb}

지정된 날짜/시간에서 월 구성요소를 검색합니다.
{#date-time-transform-functions__table_lh2_cdj_grb__entry__2}

| 입력 데이터 정제 | 출력 데이터 정제 |
|-|-|
| 날짜/시간 | 정수 - 지정된 날짜의 월 구성요소입니다. |
[ ]

{#date-time-transform-functions__table_lh2_cdj_grb}  
그림 11. 예제

* 입력 : `2021-11-20 13:06:12`
* 입력 날짜 형식: `ISO 날짜(2004-06-28) `
* 출력: `11`
{#date-time-transform-functions__ul_csm_hdj_grb}

## 주 {#date-time-transform-functions__section_ezm_ldj_grb}

지정된 날짜/시간의 주 번호를 평가합니다.
{#date-time-transform-functions__table_p3g_xdj_grb__entry__2}

| 입력 데이터 정제 | 출력 데이터 정제 |
|-|-|
| 날짜/시간 | 정수 - 지정된 날짜의 주 번호입니다. |
[ ]

{#date-time-transform-functions__table_p3g_xdj_grb} 그림 12. 예제

* 입력 : `2021-04-07 12:01:12`
* 입력 날짜 형식: `ISO 날짜(2004-06-28) `
* 출력: `15 `
{#date-time-transform-functions__ul_q4n_b2j_grb}

## 년 {#date-time-transform-functions__section_ryv_32j_grb}

지정된 날짜/시간에서 연도 구성요소를 검색합니다.{#date-time-transform-functions__table_uhb_l2j_grb__entry__2}

| 입력 데이터 정제 | 출력 데이터 정제 |
|-|-|
| 날짜/시간 | 정수 - 지정된 날짜의 연도 구성요소입니다. |
[ ]

{#date-time-transform-functions__table_uhb_l2j_grb}
그림 13. 예제

* 입력 : `2021-04-07 12:01:12`
* 입력 날짜 형식: `ISO 날짜(2004-06-28) `
* 출력: `2021`
{#date-time-transform-functions__ul_i2t_42j_grb}

## 날짜 차이 {#date-time-transform-functions__section_ahv_hfj_grb}

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

| 입력 데이터 정제 | 매개변수 | 출력 데이터 정제 |
|-|-|-|
| 날짜/시간, 날짜 또는 만료 날짜 | 날짜/시간, 날짜 또는 만료 날짜 | 기간 - Epoch 시간(1970-01-01 00:00:00)에 추가된 기간 차이입니다. |
[ ]

{#date-time-transform-functions__table_o3p_kfj_grb} 그림 14. 예제

* 입력 : `2021-05-02 09:10:12`
* 입력 날짜 형식: `ISO 날짜(2004-06-28) `
* 매개변수: `2021-04-07 06:02:23`
* 출력: `1970-01-26 03:07:49`
{#date-time-transform-functions__ul_ppk_dgj_grb}

## 월말 {#date-time-transform-functions__section_ps1_kgj_grb}

지정된 날짜에 지정된 월 수를 더한 후 월의 마지막 날을 평가합니다.
{#date-time-transform-functions__table_rvl_rgj_grb__entry__3}

| 입력 데이터 정제 | 매개변수 | 출력 데이터 정제 |
|-|-|-|
| 날짜 | 월 수 - 지정된 날짜에 추가할 월입니다. | 정수 - 지정된 입력 날짜에 개월 수를 더한 후의 마지막 날입니다. |
[ ]

{#date-time-transform-functions__table_rvl_rgj_grb} 그림 15. 예제

* 입력: `2021-11-20`
* 입력 날짜 형식: `ISO 날짜(2004-06-28) `
* 개월 수: `3`
* 출력: `2022-02-28`
{#date-time-transform-functions__ul_i4t_3hj_grb}