날짜 및 시간 함수

변수

now

현재 시간을 YYYY-MM-DD-hhss 형식으로 가져옵니다.

타임스탬프

현재 시간을 Unix 타임스탬프로 가져옵니다.

함수

addSeconds(날짜; 숫자)

날짜에 주어진 시간(초)을 추가한 결과로 새 날짜를 반환합니다. 초를 빼려면 음수를 입력합니다.

예

addMinutes(date; number) addminutes-date-number

날짜에 주어진 시간(분) 수를 추가한 결과로 새 날짜를 반환합니다. 분을 빼려면 음수를 입력합니다.

예

addHours(date; number) addhours-date-number

날짜에 지정된 시간(시) 수를 추가한 결과로 새 날짜를 반환합니다. 시간을 빼려면 음수를 입력합니다.

예

addDays(date; number) adddays-date-number

날짜에 지정된 일 수를 추가한 결과로 새 날짜를 반환합니다. 일수를 빼려면 음수를 입력합니다.

예

addWeekDays(date; number)

[새로 만들기!]{class="badge informative"}

날짜에 평일 수를 추가합니다. 정수 값만 추가됩니다(분수 값은 내림됨).

예

addWeekDays("2016-12-08T15:55:57.536Z"; 2)

2016-12-12T15 반환:55:57.536Z
addWeekDays("2016-12-08T15:55:57.536Z"; -2)
2016-12-06T15:55:57.536Z 반환

addMonths(date; number)

날짜에 지정된 개월 수를 추가한 결과로 새 날짜를 반환합니다. 월을 빼려면 음수를 입력합니다.

예

addYears (date; number)

날짜에 지정된 연도 수를 추가한 결과로 새 날짜를 반환합니다. 연도를 빼려면 음수를 입력합니다.

예

dayOfMonth(date)

[새로 만들기!]{class="badge informative"}

1과 31 사이의 숫자로 날짜 날짜를 반환합니다.

예

dayOfWeek(date)

[새로 만들기!]{class="badge informative"}

1(일요일)과 7(토요일) 사이의 숫자로 날짜의 요일을 반환합니다.

예

daysInMonth(date)

[새로 만들기!]{class="badge informative"}

주어진 일자의 월간 총 일 수를 반환합니다.

예

daysInSplitWeek(date)

[새로 만들기!]{class="badge informative"}

일자와 주의 끝 또는 월의 끝 중 먼저 도래하는 일자 사이의 총 평일 수를 반환합니다.

예

daysInYear(date)

[새로 만들기!]{class="badge informative"}

주어진 일자가 있는 연도의 총 일 수(일반 연도의 경우 365, 윤년의 경우 366)를 반환합니다.

예

dateMax(date1; date2; …)

[새로 만들기!]{class="badge informative"}

목록에서 가장 최근 날짜를 반환합니다.

예

dateMin(date1; date2; …)

[새로 만들기!]{class="badge informative"}

목록에서 가장 빠른 날짜를 반환합니다.

예

시간(날짜)

[새로 만들기!]{class="badge informative"}

날짜의 시간을 0에서 23 사이의 숫자로 반환합니다.

예

분(날짜)

[새로 만들기!]{class="badge informative"}

날짜의 분을 0에서 59 사이의 숫자로 반환합니다.

예

개월(날짜)

[새로 만들기!]{class="badge informative"}

날짜의 월을 1과 12 사이의 숫자로 반환합니다.

예

초(날짜)

[새로 만들기!]{class="badge informative"}

날짜의 초를 0과 59 사이의 숫자로 반환합니다.

예

weekDayDiff(date2; date1)

[새로 만들기!]{class="badge informative"}

두 날짜 사이의 평일 수를 반환하며, 해당 날짜의 타임스탬프를 처리합니다. 예를 들어 시작 시간이 오후 3시인 경우 시작일은 전일로 계산되지 않습니다.

예

workMinutesDiff(date1; date2)

[새로 만들기!]{class="badge informative"}

표준 월요일-금요일 오전 9시-오후 5시 일정을 기준으로 두 날짜 사이의 예약된 작업 시간(분)을 반환합니다.

예

년(날짜)

[새로 만들기!]{class="badge informative"}

날짜의 연도를 4자리 숫자로 반환합니다.

예

setSecond(date; number)

이 함수는 매개 변수에 지정된 초 수를 사용하는 새 날짜를 반환합니다.

0에서 59 사이의 숫자를 지정하십시오. 숫자가 해당 범위를 벗어나면 함수는 이전 분 (음수) 또는 이후 분 (양수)에서 1초를 반환합니다.

범위 밖의 숫자를 지정해야 하는 경우 addSeconds(날짜; 숫자) 섹션에 설명된 대로 ​ addSeconds을 사용하는 것이 좋습니다.

예

setMinute(date; number)

이 함수는 매개 변수에 지정된 분이 있는 새 날짜를 반환합니다.

0에서 59 사이의 숫자를 지정하십시오. 숫자가 해당 범위를 벗어나면 함수는 이전 시간(음수의 경우) 또는 이후 시간(양수의 경우)에서 1분을 반환합니다.

범위 밖의 숫자를 지정해야 하는 경우 addMinutes (date; number)에서 설명한 대로 addMinutes를 사용하는 것이 좋습니다.

예

setHour(날짜; 숫자)

이 함수는 매개 변수에 지정된 시간이 있는 새 날짜를 반환합니다.

0에서 23 사이의 숫자를 지정하십시오. 숫자가 이 범위를 벗어나면 함수는 전날(음수의 경우) 또는 다음날(양수의 경우)에서 한 시간을 반환합니다.

범위 밖의 숫자를 지정해야 하는 경우 addHours(date; number)에서 설명한 대로 addHours를 사용하는 것이 좋습니다.

예

setDay(날짜; 영어로 된 날짜의 번호/이름)

이 함수는 매개 변수에 지정된 날짜가 포함된 새 날짜를 반환합니다.

이 함수를 사용하여 일요일을 1로, 토요일을 7로 설정할 수 있습니다. 1에서 7까지의 숫자를 지정하는 경우 결과 날짜는 현재(일요일-토요일) 주 내에 있습니다. 숫자가 해당 범위를 벗어난 경우 함수는 이전 주(음수의 경우) 또는 후속 주(양수의 경우)에서 하루를 반환합니다.

범위 밖의 숫자를 지정해야 하는 경우에는 addDays(date; number)에서 설명한 대로 addDays를 사용하는 것이 좋습니다.

예

setDate(date; number)

이 함수는 매개 변수에 지정된 월의 일을 사용하는 새 날짜를 반환합니다.

1에서 31 사이의 숫자를 지정하십시오. 숫자가 이 범위를 벗어나면 함수는 이전 달(음수의 경우) 또는 이후 달(양수의 경우)에서 하루를 반환합니다.

예

setMonth(날짜; 영어의 월 번호/이름)

이 함수는 매개 변수에 지정된 월이 있는 새 날짜를 반환합니다.

1에서 12 사이의 숫자를 지정하십시오. 숫자가 이 범위를 벗어나면 함수는 이전 연도(음수의 경우) 또는 이후 연도(양수의 경우)의 월을 반환합니다.

예

setYear(date; number)

매개 변수에 지정된 연도가 있는 새 날짜를 반환합니다.

예:

formatDate(date; format; [timezone])

Dec 10, 2021 8:30 PM과(와) 같이 텍스트 값으로 서식을 지정하려는 Date 값(예: 12-10-2021 20:30)이 있는 경우 이 함수를 사용합니다.

이 기능은 예를 들어 동일한 시나리오에서 한 앱 또는 웹 서비스의 날짜 형식을 연결된 앱 또는 웹 서비스의 날짜 형식으로 변경해야 하는 경우 유용합니다.

자세한 내용은 문서 항목 데이터 형식의 날짜 및 텍스트를 참조하십시오.

매개변수

다른 유형이 제공되면 유형 보압이 적용됩니다. 자세한 내용은 형식 강제 변환을 참조하십시오.

반환 값 및 유형

formatDate 함수는 지정된 형식 및 시간대에 따라 지정된 Date 값의 텍스트 표현을 반환합니다. 데이터 유형은 텍스트입니다.

예: 이 예제에서 시나리오와 웹 시간대가 모두 Europe/Prague(으)로 설정되었습니다.

parseDate(text; format; [timezone])

날짜를 나타내는 Text 값(예: 12-10-2019 20:30 또는 Aug 18, 2019 10:00 AM)이 있고 이를 Date 값(이진 컴퓨터 읽기 가능 표시)으로 변환(구문 분석)하려는 경우 이 함수를 사용합니다. 자세한 내용은 문서 항목 데이터 형식의 날짜 및 텍스트를 참조하십시오.

매개변수

두 번째 열은 예상 유형을 나타냅니다. 다른 유형이 제공되면 유형 보압이 적용됩니다. 자세한 내용은 형식 강제 변환을 참조하십시오.

다른 유형이 제공되면 유형 보압이 적용됩니다. 자세한 내용은 형식 강제 변환을 참조하십시오.

반환 값 및 유형

이 함수는 지정한 형식 및 시간대에 따라 텍스트 문자열을 날짜로 변환합니다. 값의 데이터 유형은 날짜입니다.

예: 다음 예제에서 반환된 Date 값은 ISO 8601에 따라 표시되지만 결과의 데이터 형식은 Date입니다.

dateDifference(Date1; Date2; Unit)

두 날짜의 차이를 나타내는 숫자를 지정된 단위로 표시합니다.

Date2는 Date1에서 빼집니다.

unit 매개 변수에 다음 시간 값 중 하나를 사용합니다.

단위를 지정하지 않으면 이 함수는 그 차이를 밀리초로 반환합니다.

예

추가 예시

월의 n번째 요일을 계산하는 방법

이 섹션은 한 달에 n번째 요일을 가져오는 방법을 설명하는 Exceljet 웹 페이지에서 Workfront Fusion에 맞게 조정되었습니다.

월의 n번째 요일(예: 첫 번째 화요일, 세 번째 금요일 등)에 해당하는 날짜를 계산해야 하는 경우 다음 공식을 사용할 수 있습니다.

{{addDays(setDate(1.date; 1); 1.n * 7 - formatDate(addDays(setDate(1.date; 1); "-" + 1.dow); "E"))}}

수식에 포함되는 항목은 다음과 같습니다.

특정 대/소문자만 계산하려는 경우(예: 매주 두 번째 수요일) 수식의 항목 1.n 및 2.dow을(를) 해당 숫자로 바꿀 수 있습니다. 이번 달의 두 번째 수요일에 다음 값을 사용합니다.

설명:

날짜 사이의 일 수 계산 방법

한 가지 가능성은 다음 표현식을 사용하는 것입니다.

{{round((2.value - 1.value) / 1000 / 60 / 60 / 24)}}

월의 마지막 날/밀리초를 계산하는 방법

날짜 범위를 지정할 때(예: 검색 모듈에서) 범위가 이전 달 전체에 대해 닫힌 간격(해당 제한 지점을 모두 포함하는 간격)으로 걸쳐 있으면 해당 월의 마지막 날을 계산해야 합니다.

2019-09-01 ≤ D ≤ 2019-09-30

아래 수식은 이전 달의 마지막 날을 계산하는 방법 중 하나를 보여 줍니다.

{{addDays(setDate(now; 1); -1)}}

경우에 따라 월의 마지막 날뿐만 아니라 문자 그대로 마지막 밀리초를 계산해야 합니다.

2019-09-01T00:00:00.000Z ≤ D ≤ 2019-09-30T23:59:59.999Z

이 수식은 이전 달의 마지막 밀리초를 계산하는 방법을 보여 줍니다.

{{parseDate(parseDate(formatDate(now; "YYYYMM01"); "YYYYMMDD"; "UTC") - 1; "x")}}

표준 시간대 설정을 사용하기 위해 결과가 필요한 경우 UTC 인수를 생략합니다.

{{parseDate(parseDate(formatDate(now; "YYYYMM01"); "YYYYMMDD") - 1; "x")}}

그러나 다음 달의 1일을 대신 지정하고 “작거나 같음” 연산자를 다음과 같이 "보다 작음"으로 대체하면서 반열기 간격(제한 지점 중 하나를 제외한 간격)을 사용하는 것이 좋습니다.

2019-09-01 ≤ D < 2019-10-01

2019-09-01T00:00:00.000Z ≤ D < 2019-10-01T00:00:00.000Z